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PREFACE 



This manual is a reference for the programmer with some 
assemblers and assembly languages. 



knowledge of 



Using the MACRO assembler effectively involves using other 
DECSYSTEM-20 facilities: the monitor, the LINK program, the CREF 
program, a debugging program, a text editor, and machine language. 
Therefore the following DECSYSTEM-20 documents will prove useful: 

User's Guide 

AD-4179B-T1 

Monitor Calls User's Guide 
AA-4166C-TM 

LINK Reference Manual 
AA-4183B-TM 

EDIT User 's Guide 

DEC-20-UEUGA-A-D 

DDT Dynamic Debugging Technique 
DEC-10-UDDTA-A-D 

BATCH Reference Manual 
DEC-20-OBRMA-A-DN3 

Hardware Reference Manual 
EK-10/20-HR-001 



IX 



CHAPTER 1 
INTRODUCTION TO MACRO 



MACRO is the symbolic assembler program for the DECSYSTEM-20. The 
assembler reads a file of MACRO statements and composes relocatable 
binary machine instruction code suitable for loading by LINK, the 
system's linking loader. 

MACRO is a statement-oriented language; statements are in free format 
and are processed in two passes. In processing statements, the 
assembler : 

1. Interprets machine instruction mnemonics 

2. Accepts symbol definitions 

3. Interprets symbols 

4. Interprets pseudo-ops 

5. Accepts macro definitions 

6. Expands macros on call 

7. Assigns memory addresses 

8. Generates a relocatable binary program file (.REL file) for 
input to LINK 

9. Generates a program listing file showing source statements, 
the corresponding binary code, and any errors found 

10. Generates a UNIVERSAL file that can be searched by other 
assemblies 

In addition to translating machine instruction mnemonics and 
special-purpose operators called pseudo-ops, MACRO allows you to 
create your own language elements, called macros. In this way you can 
tailor the assembler's functions for each program. 

Since the assembler is device independent, you can use any peripheral 
devices for input and output files. For example, you can use a 
terminal for your source program input, a line printer for your 
program listing output, and a disk for your binary program output. 

MACRO programs must use the monitor for device-independent 
input/output services. (See the Monitor Calls User's Guide.) 
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NOTES 

The following conventions are used 
throughout this manual: 

1. All numbers in the examples are 
octal unless otherwise indicated. 

2. All numbers in the text are decimal 
unless otherwise indicated. 

3. The name of the assembler, MACRO, 
appears in uppercase letters; 
references to user-defined macros 
appear in lowercase letters. 

4. Examples sometimes show the code 
generated as it appears in the 
program listing file. This file is 
described in Section 6.1. 



1.1 HOW THE ASSEMBLER OPERATES 

MACRO is a 2-pass assembler; it reads your source program twice. On 
Pass 1, some symbolic addresses will not be resolved, if they refer to 
parts of the program not yet read. These symbolic references are 
entered in the symbol table and will be resolved on Pass 2. 

The main purpose of Pass 1 is to build symbol tables and to make a 
rudimentary assembly of each source statement. 

The first task of Pass 1 is initializing all impure data areas that 
MACRO uses (internally) for assembly. This area includes all dynamic 
storage areas and all buffer areas. 

MACRO then reads a command string into memory. This command string 
contains specifications for the files to be used during assembly. 
After scanning the command string for proper syntax, MACRO initializes 
the specified output files. 

As assembly begins, MACRO initiates a routine that retrieves source 
lines from the proper input file. If no such file is currently open, 
MACRO opens the next input file specified in the command string. 
Source lines are assembled as they are retrieved from input files. 

Assembly Pass 2 performs the same steps as Pass 1. However, during 
Pass 2 MACRO writes the object code to the binary (and usually 
relocatable) output file; it also generates the program listing file, 
followed by the symbol table listing for the program. 

MACRO can also generate a cross-referenced symbol table. (See Chapter 
6.) 

During Pass 2 MACRO also flags erroneous source statements with 
single-character error codes. (See Chapter 7.) These error codes 
appear in the program listing file. 
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The relocatable binary object file created during Pass 2 contains all 
binary code generated; this code is in a form suitable for loading by 
the LINK program. (See the LINK Reference Manual. ) 

MACRO processes relocation counters on both passes. If a labeled 
statement has a different relocation value on the second pass, MACRO 
generates a phase error. 



1.2 ADDRESSES AND MEMORY 

The address space of a DECSYSTEM-20 program consists of 512P (IP = 512 
words) , each word having 36 bits. Since the total number of storage 
locations is 2 to the 18th power, the address of a location can be 
expressed in 18 bits, or one halfword. 

The left halfword of a storage location is bits to 17; the right 
halfword is bits 18 to 35. 



1.3 RELOCATABLE ADDRESSES 

Normally the binary program generated by MACRO is relocatable. This 
means that when the program is loaded for execution, it can be loaded 
anywhere in physical memory. (The address for loading is selected at 
load time, and depends on what has already been loaded.) 

Unless you specify otherwise, MACRO assembles your binary program 
beginning with address (400000 for high-segment code) . References 
to addresses within your program are therefore relative to (400000 
for the high segment), and must be changed at loading time. LINK does 
this by adding the load address to all such relative addresses, 
resolving them to absolute addresses. 

For programs assembled with multiple PSECT counters, each PSECT begins 
with the relative address 0. At load time, each PSECT has its own 
relocation constant; PSECT origins must be selected carefully to 
avoid overlapping of PSECTs in memory. 
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CHAPTER 2 
ELEMENTS OF MACRO 



The character set recognized in MACRO statements includes all ASCII 
alphanumeric characters and 28 special characters (ASCII 040 through 
137) . Lowercase letters (ASCII 141 through 172) are treated 
internally as uppercase letters (ASCII 101 through 132) . 

MACRO also recognizes seven ASCII control codes: horizontal tab 
(Oil) , linefeed (012) , vertical tab (013) , formfeed (014) , carriage- 
return (015), CTRL/underscore (037), and CTRL/Z (032). 

MACRO accepts any ASCII character in quoted text, or as text arguments 
to the ASCII and ASCIZ pseudo-ops. 

NOTES 



1. The line-continuation character 
(CTRL/_) is always effective. 

2. Delimiters for certain pseudo-ops 
(such as ASCII, ASCIZ, and COMMENT) 
can be any nonblank, nontab ASCII 
character . 



Characters and their codes are listed in Appendix A. 

A MACRO program consists of statements made up of MACRO language 
elements. Separated into general types, these are: 

1. Special characters 

2. Numbers 

3. Literals 

4. Symbols 

5. Expressions 

6. MACRO-def ined mnemonics 

7. Pseudo-ops 

8. Macros 

The format of a MACRO statement is discussed in Chapter 4. 



2-1 



ELEMENTS OP MACRO 

2.1 SPECIAL CHARACTERS 

Characters and combinations that have special interpretations in MACRO 
are listed in Appendix B. These interpretations apply only in the 
contexts described. In particular, they do not apply within comment 
fields or text strings. 



2.2 NUMBERS 

The two properties of numbers that are important to MACRO are: 

1. In what radix (base) the number is given. 

2. How the number should be placed in memory. 

You can control the interpretation of these properties by using 
pseudo-ops or special characters to indicate your choices. 

2.2.1 Integers 

MACRO stores an integer in its binary form, right justified in bits 1 
to 35 of its storage word. If you use a sign, place it immediately 
before the integer. (If you omit the sign, the integer is assumed 
positive.) For a negative integer, MACRO first forms its absolute 
value in bits 1 to 35, then takes its two's complement. Therefore a 
positive integer is stored with in bit 0, while a negative integer 
has 1 in bit 0. 

The largest integer that MACRO can store is 377777 777777 (octal) ; 
the smallest (most negative) is 400000 000000 (octal) . 



2.2.2 Radix 

The initial implicit radix for a MACRO program is octal (base 8) . The 
integers you use in your program will be interpreted as octal unless 
you indicate otherwise. 

You can change the radix to any base from 2 to 10 by using the RADIX 
pseudo-op. (See the pseudo-op RADIX in Chapter 3.) The new radix 
will remain in effect until you change it. 

Without changing the prevailing radix, you can write a particular 
expression in binary, octal, or decimal. To do this, prefix the 
integer with ''B for binary, '*0 for octal, or ''D for decimal. The 
indicated radix applies only to the single integer immediately 
following it. 
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NOTES 



1. A single-digit number is always 
interpreted as radix 10. Thus 9 is 
seen as decimal 9, even if the 
current radix is 8. 

2. In the notations for "B, "D, and ''0, 
the up-arrow in the text indicates 
the up-arrow character, not the 
CONTROL character. 



For example, suppose the current radix is 8. Then you can write the 
decimal number 23 as: 

27 octal (current radix) 

^"023 decimal 

'^BlOlll binary 

But you cannot write decimal 23 as "D45-22 since the "D applies only 
to the first number, 45; the 22 is octal. However, you can write 
decimal 23 as "D<45-22>. 



2.2.3 Adding Zeros to Integers in Source Code 

You can add zeros to an integer (multiply it by a constant) in your 
program by suffixing K, M, or G to it. 

K adds 3 zeros (K = "kilo-", thousands) 
M adds 6 zeros (M = "mega-", millions) 
G adds 9 zeros (G = "giga-", billions) 

These zeros are suffixed before any conversion, so that in radix 10, 
5K means 5000 decimal; in radix 8, 5K means 5000 octal, or 2560 
decimal. 



2.2.4 Fixed-Point Decimal Numbers 

To indicate a fixed-point decimal number, prefix it with '^F, include a 
decimal point wherever you wish, and suffix Bn to show that you want 
to place the "assumed point" after bit n in the storage word. If you 
omit the decimal point, MACRO assumes that it follows the last digit. 
If you omit the Bn, MACRO assumes B35. 

To handle the number, MACRO forms the integer part in a fullword 
register, and the fractional part in another fullword register. It 
then places the integer part (right justified) in bits 1 to n (n is 
from your Bn) of a binary word, and the fractional part (left 
justified) in the remaining bits. The integer part is truncated at 
the left, and the fractional part at the right. Bit shows the sign 
of the number. 
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For example, ''F123.45B8 is formed in two registers as 

000000 000173 (integer part, right justified) 

346314 631462 (fractional part, left justified) 

Since the Bn operator sets the assumed point after bit 8, the integer 
part is placed in bits 1 to 8, and the fractional part in bits 9 to 
35. (The sign bit is 0, showing a positive number.) Truncation is 
on the left and right, respectively, giving 

173 346 314631 

assumed point 

You can show a fixed-point decimal number as negative by placing a 
minus sign before the ''F. The absolute value of the negative number 
is formed in two registers as a positive number, then two's 
complemented. This complementing sets bit to 1, showing that the 
number is negative. 



NOTE 

The binary number resulting from ''F does 
not show where the assumed point should 
be. You must keep track of this through 
your own programming conventions. 



Examples: 

000000 000173 

000173 346314 

346314 631462 

777777 777604 

777604 431463 

431463 146316 



T123»45 

T123»45B17 

T123»45B-1 

■"F123»45 

-'^F123»45B17 

■'"F123»45B-1 



2.2.5 Floating-Point Decimal Numbers 

In your program, a floating-point decimal number is a string of digits 
with a leading, trailing, or embedded decimal point and an optional 
leading sign. MACRO recognizes this as a mixed number in radix 10. 

MACRO forms a floating-point decimal number with the sign in bit 0, a 
binary exponent in bits 1 to 8 , and a normalized binary fraction in 
bits 9 to 35. 

The normalized fraction can be viewed as follows: its numerator is 
the binary number in bits 9 to 35, whose value is less than 2 to the 
28th power, but greater than or equal to 2 to the 27th power. Its 
denominator is 2 to the 28th power, so that the value of the fraction 
is always less than 1, but greater than or equal to 0. (This value is 
only if the entire stored number is 0.) 
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The binary exponent is incremented by 128 so that exponents from -128 
to 127 are represented as to 255. 

For a negative floating-point decimal number, MACRO first forms its 
absolute value as a positive number, then takes the two's complement 
of the entire word. 

Examples: 

The floating-point number 17. generates the binary 

10 000 101 100 010 000 000 000 000 000 000 000 

where bit shows the positive sign, bits 1 to 8 show the binary 
exponent, and bits 9 to 35 show the proper binary fraction. The 
binary exponent is 133 (decimal) , which after subtracting the added 
128 gives 5. The fraction is equal to 0.53125 decimal. And 0.53125 
times 2 to the 5th power is 17, which is the number given. 

Similarly, 153. generates 

10 001 000 100 110 010 000 000 000 000 000 000 
while -153. generates 

1 01 110 111 Oil 001 110 000 000 000 000 000 000 

These two examples show that a negative number is two's complemented. 
Notice that since the binary fraction for a negative number always has 
some nonzero bits, the exponent field (taken by itself) appears to be 
one's complemented. 

As in FORTRAN, you can write a floating-point decimal number with a 
suffixed E±n, and the number will be multiplied by 10 to the ±nth 
power. If the sign is missing, n is assumed positive. 

Examples: 

2840000. can be written 284. E+4 

2840000. can be written .284E7 

.0000284 can be written .284E-4 

.0000284 can be written 284. E-7 

Using this E notation with an integer (no decimal point) is not 
allowed, and causes an error. Therefore you can use 284. E4, but 284E4 
is illegal. 

NOTE 

MACRO'S algorithm for handling numbers 
given with the E notation is not 
identical to FORTRAN'S. The binary 
values generated by the two translators 
may differ in the lowest order bits. 
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2.2.6 Binary Shifting 

Binary shifting of a number with Bn sets the location of the rightmost 
bit at bit n in the storage word, where n is a decimal integer. The 
shift takes place after the binary number is formed. Any bits shifted 
outside the range (bits to 35) of the storage word are lost. 

For example, here are some numbers with their binary representations 
given in octal: 



300000 000000 

000000 042000 

000001 000000 
400000 000000 
777777 777777 
000000 000001 
000000 777777 



'"D3B2 

-^017625 

1B17 

IBO 

-1B35 

1B35 

-1B35 



2.2.7 Underscore Shifting 

You can also shift a number by using the underscore operator, (On 
some terminals this is a left-arrow.) If V is an expression with 
value n, suffixing _V to a number shifts it n bits to the left. (If n 
is negative, the shift is to the right.) 

In an expression of the form W-V, W and V can be any expressions 
including symbols. The binary value of W is formed in a register, V 
is evaluated, and the binary of W is shifted V bits when placed in 
storage. 



NOTE 

An expression such as -3. 75E4_''D18 is 
legal, but the shift occurs after 
conversion to floating-point decimal 
storage format. Therefore the sign, 
exponent, and fraction fields are all 
shifted away from their usual locations. 
This is true also for other storage 
formats. 



2.2.8 Querying the Position of a Bit Pattern 

You can query the position of a bit pattern by prefixing ''L (up-arrow 
L) to an expression. This generates the number of leading zeros in 
the binary value of the expression. ("LO generates 36 decimal.) 
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For example, suppose the current radix is 10. Then 

''L153 generates 35 (29 decimal) 

"L153. generates 1 

'"L-153 generates 

'"L-153. generates 

In the first example, "L153 generates 29 (decimal) because the binary 
representation of 153 decimal has its leftmost 1 in bit 28: 

000 000 000 000 000 000 000 000 000 010 Oil 001 

But in the second example, the binary form of 153. is in 
floating-point format (see Section 2.2.5), 

010 001 000 100 110 010 000 000 000 000 000 000 

and its leftmost 1 is in bit 1. 

In both of the last two examples, '^L-153 and ''L-153. generate 0. This 
is because a negative number in any format sets bit to 1. 

2.3 LITERALS 

A literal is a character string within square brackets inserted in 
your source code. MACRO stores the code generated by the enclosed 
string in a literal pool beginning with the first available literal 
storage location, and places the address of this location in place of 
the literal. The literal pool is normally at the end of the binary 
program. (See the pseudo-op LIT in Chapter 3.) 

The statements 

135 01 00 002016' LDB T1>CP0INT 6fJBVERrl73 

LIT 
22 06 00 000137 

are equivalent to 

135 01 00 002020' LDB Tlr PLACE 

* * * 

22 06 00 000137 PLACE: POINT 6r»JBVERrl7 

A literal can also be used to generate a constant: 

PUSH 17ri:03 ^Generate zero fullword 

MOVE LrC3»i'lII J Generate 3 word with 3 in 

y lefthalf and 14 in ridhthalf 
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Multiline literals are also allowed: 

GETCHR: ILDB T2fTl fGet a character 

CAIN T2f0 ils it a null? 

JRST CMOVE T1»TXTPTR JYesf retrieve pointer 
ILDB T2rTl JGet a new character 
CAIN J2f'?' 5Is it a Question mark? 

JRST CMOVE TlrTXTPTl ?Yesr det alternate pointer 

ILDB T2)'T1 ?Get the message character 

JRST GETHLP3 rGo to help routine 
POP J PrII JNot Question mark» return 
POP J Ry rNot a nully return 

The text of a literal continues until a matching closing square 
bracket is found (unquoted and not in comment field) . 

A literal can include any term, symbol, expression, or statement, but 
it must generate at least one but no more than 99 words of data. A 
statement that does not generate data (such as a direct-assignment 
statement or a RADIX pseudo-op) can be included in a literal, but the 
literal must not consist entirely of such statements. 

You can nest literals up to 18 levels. You can include any number of 
labels in a literal, but a forward reference to a label in a literal 
is illegal. 

If you use a dot (.) in a literal to retrieve the location counter, 
remember that the counter is pointing at the statement containing the 
literal, not at the literal itself. 

In nested literals, a dot location counter references a statement 
outside the outermost literal. 

In the sequence 

JRST CHRRZ ACl^V 

CAIE AC1»0P 

JRST ♦+! 

JRST EVTSTS3 
SKIPE C 

the expression .+1 generates the address of SKIPE C, not JRST EVTSTS. 

Literals having the same value are collapsed in MACRO'S literal pool. 
Thus for the statements: 

PUSH PtZOl 
PUSH PfLOl 
MOVEI AClrCASCIZ /TESTl/D 

the same address is shared by the two literals [0] , and by the null 
word generated at the end of [ASCIZ /TESTl/] . Literal collapsing is 
suppressed for those literals that contain errors, undefined 
expressions, or EXTERNAL symbols. 
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2.4 SYMBOLS 

MACRO symbols include: 

1. MACRO-def ined pseudo-ops (discussed in Chapter 3) 

2. MACRO-def ined mnemonics (discussed in Section 2.6) 

3. User-defined macros (discussed in Chapter 5) 

4. User-defined opdefs. (discu3sed at OPDEF in Chapter 3) 

5. User-defined labels (discussed in this section) 

6. Direct-assignment symbols (discussed in Section 2.4.2.2) 

7. Dummy-arguments for macros (discussed in Chapter 5) 
MACRO stores symbols in three symbol tables: 

1. Op-code table: machine instruction mnemonics and pseudo-ops 

2. Macro table: macros, user-defined OPDEFs, and synonyms 
(See the SYN pseudo-op in Chapter 3.) 

3. User symbol table: labels and direct-assignment symbols 

An entry in one of these tables shows the symbol, its type, and its 
value. 

Symbols are helpful in your programs because: 

1. Defining a symbol as a label gives a name to an address. You 
can use the label in debugging or as a target for program 
control statements. 

2. In revising a program, you can change a value throughout your 
program by changing a symbol definition, 

3. You can give names to values to make computations clearer. 

4. You can make values available to other programs. 



2.4,1 Selecting Valid Symbols 

Follow these rules in selecting symbols: 

1, Use only letters, numerals, dots (.), dollar signs ($) / and 
percent signs (%) . MACRO will consider any other character 
(including a blank) as a delimiter. 

2, Do not begin a symbol with a numeral, 

3, If you use a dot for the first character, do not use a 
numeral for the second. Do not use dots for the first two 
characters; doing so can interfere with MACRO'S created 
symbols, (See Section 5,5,2,) 

4, Make the first six characters unique among your symbols. You 
can use more than six characters, but MACRO will use only the 
first six. 
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Examples: 

VELOCITY (legal, only VELOCI is meaningful to MACRO) 

CHG.VEL (legal, only CHG.VE is meaningful to MACRO) 

CHG VEL (illegal, looks like two symbols to MACRO) 

ISTNUM (illegal, begins with a numeral) 

NUMl (legal) 

.1111 (illegal, begins with dot-numeral) 

..1111 (unwise, could interfere with created symbols) 



2.4.2 Defining Symbols 

You can define a symbol by making it a label or by giving its value in 
a direct-assignment statement. Labels cannot be redefined, but 
direct-assignment symbols can be redefined anywhere in your program. 

You can also define special-purpose symbols called OPDEFs and macros 
using the pseudo-op OPDEF and the pseudo-op DEFINE. (See Chapter 3.) 



2.4.2.1 Defining Labels - A label is always a symbol with a suffixed 
colon. A label is in the first (leftmost) field of a MACRO statement 
and is one of the forms: 



ERRFOUND: 

CASEl: 

OK:CONTIN: 

CASE2: : 

CASES :! 

CASE4: :! 



(MACRO uses only ERRFOU) 

(legal label) 

(legal; you can use more than one label 
at a location) 

(double colon declares label INTERNAL; 
see Section 2.4.5.2) 

(colon and exclamation point suppresses 
output by debugger) 

(double colon and exclamation point 
declares label INTERNAL and suppresses 
output by debugger) 
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When MACRO processes the label, the symbol and the current value of 
the location counter are entered in the user symbol table. A 
reference to the symbol addresses the code at the label. 

You cannot redefine a label to have a value different from its 
original value. A label is relocatable if the address it represents 
is relocatable; otherwise it is absolute. 



2.4.2.2 Direct Assignments - You define a direct-assignment symbol by 
associating it with an expression. (See Section 2.5 for a discussion 
of expressions.) A direct assignment is in one of the forms: 



symbol =expr ess ion 



symbol ==expr ess ion 



symbol=: expression 



(symbol and value of expression 
entered in user symbol table) 



are 



(symbol and value of expression are 
entered in user symbol table, output by 
debugger is suppressed) 

(symbol and value of expression are 
entered in user symbol table, symbol is 
declared INTERNAL; see Section 2.4.5.2) 



symbol==: expression 



(symbol and value of expression are 
entered in user symbol table, symbol is 
declared INTERNAL, output by debugger is 
suppressed) 



You can redefine a direct-assignment symbol at any time; 
direct assignment simply replaces the old definition. 



the new 



NOTE 

If you assign a multiword value using 
direct assignment, only the first word 
of the value is assigned to the symbol. 
For example, A=ASCIZ /ABCDEFGH/ is 
equivalent to A=ASCIZ /ABODE/, since 
only the first five characters in the 
string correspond to code in the first 
word . 



2.4.3 Variable Symbols 

You can specify a symbol as a variable by suffixing it with a number 
sign (#) . A variable symbol needs no explicit storage allocation. On 
finding your END statement, MACRO assembles variables into locations 
following the literal pool. 

You can assemble variables anywhere in your program by using the VAR 
pseudo-op. This pseudo-op causes all variables found so far to be 
assembled immediately. (Variables found after the VAR statement are 
assembled at the end of the program or at the next VAR statement.) 
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2.4.4 Using Symbols 

When you use a symbol in your program, MACRO looks it up in the symbol 
tables. Normally MACRO searches the macro table first, then the 
op-code table, and finally the user symbol table. However, if MACRO 
has already found an operator in the current statement and is 
expecting operands, then it searches the user symbol table first. 

You can control the order of search for symbol tables by using the 
pseudo-op .DIRECTIVE MACPRF. 



2.4.5 Symbol Attributes 

The value of a symbol is either relocatable or absolute. The 
relocatability of a label is determined by the relocatability of the 
address assigned to it. You can define either an absolute or a 
relocatable value for a direct-assignment symbol. 

In addition, each symbol in your program has one of the following 
attributes: local, INTERNAL global, or EXTERNAL global. This 
attribute is determined when the symbol is defined. 



2.4.5.1 Local Symbols - A local symbol is defined for the use of the 
current program only. You can define the same symbol to have 
different values in separately assembled programs. A symbol is local 
unless you indicate otherwise. 



2.4.5.2 Global Symbols - A global symbol is defined in one program, 
but is also available for use in other programs. Its table entry is 
visible to all programs in which the symbol is declared global. 

A global symbol must be declared INTERNAL in the program where it is 
defined; it can be defined in only one program. In other programs 
sharing the global symbol, it must be declared EXTERNAL; it can be 
EXTERNAL in any number of programs. 

To declare a symbol as INTERNAL global, you can: 

1. Use the INTERN pseudo-op. 

INTERN FLAGl 

2. Insert a colon after = in a direct-assignment statement. 

FLAG2=:200 
FLAG3==:200 

3. Use an extra colon with a label. 

FLAG4:: 

4. For subroutine entry points, use the ENTRY pseudo-op. (This 
pseudo-op does more than declare the symbol INTERNAL. See 
Chapter 3.) 

ENTRY FLAGS 
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To declare a symbol as an EXTERNAL global, you can: 

1. Use the EXTERN pseudo-op. 

EXTERN FLAG6 

2. Suffix ## to the symbol at any of its uses. (Doing this once 
is sufficient, but you can use ## with all references to the 
symbol . ) 

FLAG?** 



2.5 EXPRESSIONS 

You can combine numbers and defined symbols with arithmetic and 
logical operators to form expressions. You can nest expressions by 
using angle brackets. MACRO evaluates each expression (innermost 
nesting levels first), and either resolves it to a fullword value, or 
generates a Polish expression to pass to LINK. (See Sections 2.5.3 
and 2.5.4.) 



2.5.1 Arithmetic Expressions 

An arithmetic expression can include any number or defined symbol, and 
any of the following operators: 

+ addition 

- subtraction 

* multiplication 

/ division 

These examples assume that WORDS, X, Y, and Z have been defined 
elsewhere: 

MOVEI 3fU0RDS/5 

ADD I 12»<X+Y-Z> 

ADD I 12»«U0RDS/5>+l>«5 



2.5.2 Logical Expressions 

A logical expression can include any number or defined symbol whose 
value is absolute, and any of the following operators: 

& AND 

! OR (inclusive- OR) 

"! XOR (exclusive OR) 

"- NOT 
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The unary operation ''-A generates the fullword one's complement of the 
value of A. 

Each of the binary operations &, I, and "l generates a fullword by 

performing the indicated operation over corresponding bits of the two 

operands. For example, A&B generates a fullword whose bit is the 
result of A's bit ANDed with B's bit 0, and so forth for all 36 
bits. 



2.5.3 Polish (Complex) Expressions 

MACRO cannot evaluate certain expressions containing relocatable 
values or EXTERNAL symbols. Instead MACRO generates special 
expressions called Polish expressions, which tell LINK how to resolve 
the values at load time. MACRO also generates Polish expressions to 
resolve inter-PSECT references. 

For example, assume that A and B are externally defined symbols. Then 
MACRO cannot perform the operations A+B-3, but instead generates a 
special Polish block containing an expression to pass to LINK; the 
expression is equivalent to -+AB3. (See REL Block Type 11 in the LINK 
Reference Manual. ) At load time, the values of A and B are available 
to LINK, and the expression is resolved. 



NOTE 

If you have used reverse Polish notation 
with a calculator, you should notice 
that although MACRO'S Polish expressions 
are similar, they are not reversed. 
(These notations are called Polish 
because they were invented by the Polish 
logician Jan Lukasiewicz.) 



2.5.4 Evaluating Expressions 



2.5.4.1 Hierarchy of Operations - MACRO has a hierarchy of operations 
in evaluating expressions. In an expression without nests (angle 
brackets) , or within a nested expression, MACRO performs its 
operations in this effective order: 

1. All unary operations and shifts: +, -, '*-, '*D, '*0, '^B, B 
(binary shift) , - (underscore shift) , '*F, "L, E, K, M, G. 
Zeros are added for K, M, and G before any other operation is 
performed. 

2. Logical binary operations (from left to right): ! (OR), ** ! 
(XOR) , & (AND) . 

3. Multiplication and division (from left to right): *, /. 

4. Addition and subtraction (binary operations) : +, -. 
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You can override this hierarchy by using angle brackets to show what 
you want done first. For example, suppose you want to calculate the 
sum of A and B, divided by C. You cannot do this with A+B/C because 
MACRO will perform the division B/C first, then add the result to A. 
With angle brackets you can write the expression <A+B>/C, telling 
MACRO to add A and B first, then divide the result by C. 

Expressions can be nested to any level. The innermost nest is 
evaluated first; the outermost, last. Some examples of legal 
expressions (assuming that Al, Bl, and C are defined symbols) are: 

Al+Bl/5 
<Al+Bl>/5 
'^-AlSBl'^iC 
'^B101M-"D98+6 



NOTE 

An expression given in halfword notation 
(that is, lef thalf , ,righthalf ) has each 
half evaluated separately in a 36-bit 
register. Then the 18 low-order bits of 
each half are joined to form a fullword. 
For example, the expression <4,,6>/2 
generates the value 000002 000003. 



2.5.4.2 Evaluating Expressions with Relocatable Values - The value of 
an expression is usually either absolute or relocatable. Recall that 
relocatable values in your binary code will have the relocation 
constant added at load time by LINK. 

Assume that A and B are relocatable symbols, and that X and Y are 
absolute symbols, and that the relocation constant is k. Let a+k and 
b+k be the values of A and B after relocation. Then A+X makes sense 
(to LINK) because it means <a+k>+X, which is the same as <a+X>+k, 
clearly relocatable. 

Since X and Y are both absolute, any operation combining them gives an 
absolute result. 

Now look at the expression A+B. This means <a+k>+<b+k>, which is the 
same as <a+b>+2k, neither absolute nor relocatable. Similarly, A*B 
means <a+k>*<b+k>, or <a*b>+<a+b>*k+k*k, again neither absolute nor 
relocatable. Such expressions cannot be evaluated by MACRO and are 
passed as Polish expressions to LINK. 

More generally, you can see if an expression is absolute or 
relocatable by substituting relocated forms as above (for example, 
a+k) , and separating it (if possible) into the form 

absolute+n*k 

where absolute is an absolute expression. If n=0, the expression is 
absolute; if n=l, it is relocatable. If n is neither nor 1, or if 
the expression cannot be put into the form above, then the expression 
is neither absolute nor relocatable. (Nevertheless, LINK will 
correctly evaluate the expression at load time.) 
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2.6 MACRO-DEFINED MNEMONICS 

MACRO-def ined mnemonics are words that MACRO recognizes and can 
translate to binary code. These mnemonics include: 

1. Machine instruction mnemonics 

2. I/O instruction mnemonics 

3. I/O device code mnemonics 

4. KLIO EXTEND instruction mnemonics 

5. JRST and JFCL mnemonics 

Each type of mnemonic is discussed and tabulated in Appendix C. These 
mnemonics, together with MACRO'S pseudo-ops and special characters, 
form the MACRO language. 
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CHAPTER 3 
PSEDDO-OPS 



A pseudo-op is a statement that directs the assembler to generate code 
or set switches to control assembly and listing of your program. For 
example, the pseudo-op RADIX does not generate code, but it tells 
MACRO how to interpret numbers in your program. The pseudo-op EXP 
generates one word of code for each argument given with it. 

To use a pseudo-op in your program, follow it with a space or tab, and 
any required or optional arguments or parameters. The program 
examples in Appendix D show pseudo-ops used in context. 

This chapter describes the use and functions of each pseudo-op 
(alphabetically). The headings included for each description, if 
applicable, are: 

1 . FORMAT 

2. FUNCTION 

3. EXAMPLES 

4. . OPTIONAL NOTATIONS 

5. RELATED PSEUDO-OPS 

6. COMMON ERRORS 

Some entries under COMMON ERRORS cite single-character error codes 
(for example, M error). These codes are discussed in Section 8.2. 

Many of the examples show some parts of the code assembled. The 
format and meaning of assembled code is discussed in Section 6.1. 
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ARRAY 



FORMAT 



FUNCTION 



ARRAY sym [expression] 

expression = an integer value in the current radix, 
indicating the number of words to be allocated; 
the expression cannot be EXTERNAL, relocatable, or 
a floating-point decimal number, and its value 
must not be negative. 

Reserves a block of storage whose length is the value 
of the expression, and whose location is identified by 
the symbol. Storage is allocated along with other 
variable symbols in the program. 

If the pseudo-op TWOSEG is used, ARRAY storage must be 
in the low segment. (See the VAR pseudo-op.) 

The allocated storage is not necessarily zeroed. 

If you use ARRAY in a PSECT, storage is allocated 
within that PSECT. 



NOTE 

Though the expression portion of an OPDEF must 
be in square brackets, this use of the brackets 
is completely unrelated to literals or literal 
handling. 



EXAMPLES 



ARRAY STARTC200D 
ARRAY PLACEC 10003 
ARRAY ERRSC20003 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



ARRAY syml,sym2 [expression] 

Both syml and sym2 have a length equal to the value of 
the expression. 

BLOCK, .COMMON, INTEGER, VAR 



COMMON 
ERRORS 



Using an EXTERNAL symbol for name or size of the array 
(E error) . 
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ASCII 



FORMAT 



ASCII dtex.td 



FUNCTION 



d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

text = string of text characters to be entered. 

Enters ASCII text in the binary code. Each character 
uses seven bits. Characters are left justified in 
storage, five per word, with bit 35 in each word set to 
0, and any unused bits in the last word set to 0. 



EXAMPLES 



105 122 122 117 122 
040 115 105 123 123 
101 107 105 000 000 



ASCII /ERROR MESSAGE/ 



123 124 101 122 124 
111 116 107 040 101 
107 101 111 116 000 



ASCII ! STARTING AGAIN! 



105 116 104 123 040 
127 111 124 110 040 
132 105 122 117 123 



ASCII TENDS WITH ZEROS? 



OPTIONAL Omit the space or tab after ASCII. This is not allowed 

NOTATIONS if the delimiter is a letter, number, dot, dollar sign, 

or percent sign (that is, a possible symbol 

constituent) , or if the ASCII value of the delimiter 

character is less than 040 or greater than 172. 

Right justified ASCII can be entered by using double 
quotes to surround up to five characters; for example. 



201 01 00 000101 



MOVEI AClf'A' 



RELATED 
PSEUDO-OPS 



ASCIZ, .DIRECTIVE FLBLST, RADIX50, SIXBIT 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 

Using more than 5 characters in a right-justified ASCII 
string, or more than 2 characters if in the address 
field (Q error) . 

Giving direct assignment of a long ASCII string value 
to a symbol (for example A=ASCII /ABCDEFGH/) . Only the 
first word (five characters, left justified) is 
assigned . 

Using ASCII when ASCIZ is required. 
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ASCIZ 



FORMAT 



ASCIZ dtextd 



FUNCTION 



d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

text = string of text characters to be entered. 

Enters ASCII text exactly as in the pseudo-op ASCII, 
except that a trailing null character is guaranteed. 
That is, if the number of characters in text is a 
multiple of five, a fullword of zeros is generated. 



EXAMPLES 



105 122 122 117 122 
040 115 105 123 123 
101 107 105 000 000 



ASCIZ /ERROR MESSAGE/ 



123 124 101 122 124 
111 116 107 040 101 
107 101 111 116 000 



ASCIZ ! STARTING AGAIN 



105 116 104 123 040 
127 111 124 110 040 
132 105 122 117 123 
000 000 000 000 000 



ASCIZ ?ENDS WITH ZEROS? 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Omit the space or tab after ASCIZ. This is not allowed 
if the delimiter is a letter, number, dot, dollar sign, 
or percent sign (that is, a possible symbol 
constituent) , or if the ASCII value of the delimiter 
character is less than 040 or greater than 172. 

ASCII, .DIRECTIVE FLBLST, RADIX50, SIXBIT 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 

Giving direct assignment of a long ASCII string value 
to a symbol (for example A=ASCII /ABCDEFGH/) . Only the 
first word (five characters, left justified) is 
assigned. 

In a macro, using a delimiter character that interferes 
with recognition of a dummy-argument. For example, in 
the macro 

DEFINE FOO(X)< 
ASCIZ tX* 



X is not seen as a dummy-argument because .X. is itself 
a valid symbol. 

(Continued on next page) 
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ASCIZ (Cont.) 



In the macro 



DEFINE FOO(X)< 
ASCIZ /X/ 



X is seen as a dummy-argument because the slash (/) i 
not valid in a symbol. 

The macro 

DEFINE FOO(X)< 
ASCIZ ♦'X'* 

uses the concatenation operator (') to assure 
recognition of X as a dummy-argument. (See Section 5.4 
for a discussion on concatenating arguments.) 
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.ASSIGN 



FORMAT 



FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



.ASSIGN syinl,sym2, increment 

syml and syra2 = global symbols. 

increment = expression with integer value. 

MACRO generates a REL Block Type 100. (See the LINK 
Reference Manual. ) At the time the program is loaded 
into memory, assigns the value of sym2 to syml, and 
adds increment to sym2. 

The .ASSIGN pseudo-op is useful for assigning a block 
of storage in one module and providing another module 
with the symbols needed to reference that block. 



♦ASSIGN AyPCyS 



yAssis^ns the value of PC to A? 
? tho?ri redefines the v<3luo? of 
y PC to be PC+5* 



♦ ASSIGN ERRlyERRSyERNO xAssiilns the value of ERRS to 

5 ERRly then redefines ERRS to 
5 be ERRS Plus the current 
y value of ERNO» 

.ASSIGN syml,sym2 

If the increment is missing, its value is 1. 

Syml or sym2 not global. 

Increment not defined at assembly time. 
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ASDPPRESS 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



ASUPPRESS 

Causes all local or INTERNAL symbols that are not 
referenced after the ASUPPRESS to be deleted from 
MACRO'S symbol table at the end of Pass 2. These 
symbols will not be output to LINK, will not be 
available to the debugger, and will not appear in the 
symbol table in the program listing file. 

If you use ASUPPRESS at the end of Pass 1, only those 
symbols defined or referenced in Pass 2 remain in 
MACRO'S symbol table. This is useful for parameter 
files that define many more symbols than are actually 
used, since the unused symbols can be automatically 
deleted if they are defined in IFl conditionals. 

PURGE, SUPPRESS 
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BLOCK 



FORMAT 



FUNCTION 



EXAMPLES 



BLOCK expression 

expression = an integer value in the current radix, 
indicating the number of words to be allocated; 
the expression cannot be EXTERNAL, relocatable, or 
a floating-point decimal number, and its value 
must not be negative. 

Reserves a block of locations whose length is the value 
of the expression. The location counter is incremented 
by this value. The allocated locations are not 
necessarily zeroed. 

Note that the BLOCK pseudo-op does not generate or 
store code. Therefore it should not be used in a 
literal, since this will result in overwriting the 
reserved space during literal pooling. 

If you use the BLOCK pseudo-op to reserve words meant 
for data storage, these words should be reserved in the 
low segment of a two-segment program. 



002101' 200 02 00 400033' 
002102' 251 02 00 003010' 



MOVE 2rCXWri FRMrTOn 
BLT 2rT0END 



002611 
002711 



* * * 



frm: 
to: 



003010' 



BLOCK 100 
BLOCK 100 
T0END=,-1 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Use the pseudo-op Z inside literals. 

ARRAY, .COMMON, INTEGER, VAR 

Relocatable expression (R error) . 
Floating-point or negative expression (A error) . 
Value of expression larger than 777777. 
Expression contains EXTERNAL symbol (E error) . 
Expression contains nonexistent symbol (V error) 
BLOCK used in literal (L error). 
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BYTE 



FORMAT 



FUNCTION 



EXAMPLES 



COMMON 
ERRORS 



BYTE bytedef . . . bytedef 

bytedef= (n) expression, . . . , expression 

n = byte size in bits; n is a decimal expression in 
the range 1 to 36. 

expression = value to be stored. 

Stores values of expressions in n-bit bytes, starting 
at bit of the storage word. The first value is 
stored in bits to n-1; the second in bits n to 2n-l; 
and so forth for each given value. 

If a byte will not fit in the remaining bits of a word, 
the bits are zeroed and the byte begins in bit of the 
next word. If a value is too large for the byte, it is 
truncated on the left. 

If the byte size is or is missing (empty 
parentheses), a zero word is generated. 

000002 yEL0CY=2 
05 00 00 01 05 02 BYTE (6)5»0» » 101 »5r VELOCY 

generates the storage value 050000 010502. The two 
commas indicate a null argument; the 101 (octal) is 
too large for the byte size and is left truncated. 

07 00 01 007 000 BYTE (6)7»0» 1 (9)7»0> 1 » " A" 
001 101 000000 

Notice that the code for "A" (101) is right justified 
in its 9-bit byte. 

Byte size too big (A error) . 

Missing left or right parenthesis (A error) . 

Extraneous comma before left parenthesis; the comma 
generates a null byte. 

Using an EXTERNAL symbol or EXTERNAL complex expression 
for n or expression. 
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PSEDDO-OPS 



COMMENT 



FORMAT 



COMMENT dtextd 

d = delimiter; the first nonblank character, whose 
second appearance terminates the text. 

text = text to be entered as a comment. 



FUNCTION 



Treats the text between the delimiters as a comment. 
The text can include a CR-LF to facilitate multiline 
comments, as shown below. 



EXAMPLES 



OPTIONAL 
NOTATIONS 



COMMENT /THIS IS A COMMENT 
THAT IS MORE THAN 1 LINE LONG/ 

Omit the space or tab after COMMENT. This is not 
allowed if the delimiter is a letter, number, dot, 
dollar sign, or percent sign (that is, a possible 
symbol constituent) , or if the ASCII value of the 
delimiter character is less than 040 or greater than 
172. 



Use a semicolon (;) to make the rest of the line into a 
comment. 



RELATED 
PSEUDO-OPS 



REMARK 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 
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PSEDDO-OPS 



. COMMON 



FORMAT 



FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.COMMON symbol [expression] 

symbol = name of a* FORTRAN COMMON block. 

expression = an expression having a positive integer 
value; this value defines the length of the 
COMMON block. 

Defines a FORTRAN or FORTRAN-compatible COMMON block. 
Causes the equivalent action of a FORTRAN labeled 
COMMON. (See the FORTRAN Reference Manual .) 

You can use .COMMON to define blank COMMON; to do 
this, use the symbol .COMM. as the name of the COMMON 
block. (Both FORTRAN and LINK recognize this as the 
name of blank COMMON.) 

To define a COMMON block, MACRO generates a REL Block 
Type 20. (See the LINK Reference Manual .) 

If used, the .COMMON pseudo-op must precede any MACRO 
statement that generates binary code, and must precede 
any other reference to the symbol name. 

♦COMMON DATAirSOD 

.COMMON symbol , . . . , symbol [expression] 

defines a COMMON array for each symbol given. Each 
array has a length equal to the value of the 
expression. 

ARRAY, BLOCK, EXTERN, INTEGER 

Missing left or right square bracket (A error) . 

Using a relocatable value or EXTERNAL symbol in 
expression. 
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PSEDDO-OPS 



.CREF 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.CREF 

Resumes output of cross-referencing that was suspended 
by the .XCREF pseudo-op. 

Can apply to specific symbols to cancel a previous 
.XCREF on those symbols, as in 

.CREF symbol, ... ,symbol 

.XCREF 



Specifying a nonexistent symbol (A error) . 
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PSEDDO-OPS 




FORMAT 
FUNCTION 

EXAMPLES 



DEC expression, ... ^expression 

Defines the local radix for the line as decimal; the 
value of each expression is entered in a fullword of 
code. The location counter is incremented by 1 for 
each expression. 



000000 
203440 
202622 
055452 
000000 



000012 
000000 
077714 
456522 
000003 



RADIX 8 

DEC 10r4.5»3»1416»6»03E-26r3 



OPTIONAL Use the EXP pseudo-op and prefix '^D to each expression 

NOTATIONS that must be evaluated in radix 10. In the example 

above, only the first expression, "10," has different 

evaluations in radix 8 and radix 10. Therefore an 

equivalent notation is 



000000 
203440 
202622 
055452 
000000 



000012 
000000 
077714 
456522 
000003 



EXP '"D10r4.5f3»1416f6»03E-26»3 



RELATED 
PSEUDO-OPS 



EXP, RADIX, OCT 
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PSEDDO-OPS 



DEFINE 



FORMAT 



FUNCTION 

EXAMPLES 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



DEFINE itiacroname (darglist) <macrobody> 

macronarae = a symbolic name for the macro defined. 
This name must be unique among all macro, OPDEF, 
and SYN symbols. 

darglist = a list of dummy-arguments. 

macrobody = source code to be assembled when the macro 
is called. 

Defines a macro. (See Chapter 5.) 

See Chapter 5. 

.DIRECTIVE (with .ITABM, .XTABM, or MACMPD arguments), 
IRP, IRPC, OPDEF, STOPI, SYN 

Mismatched parentheses. 

Mismatched angle brackets. 

Using identical names for a macro and an OPDEF or SYN 
symbol (X error) . 
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PSEODO-OPS 



DEPHASE 



FORMAT 
FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 



DEPHASE 

Suspends the effect of a PHASE pseudo-op. Restores the 
location counter to its mode previous to the segment of 
PHASEd code. 

For further details, see the pseudo-op PHASE. 

400000' RELOC 400000 

000000 PHASE 

000000 201 01 00 000000 tag: MOVEI IrO 
400001' DEPHASE 

400001' 254 00 00 000000' JRST TAG 

PHASE 
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PSEDDO-OPS 



DIRECTIVE 



FORMAT 
FUNCTION 



.DIRECTIVE directive, ... ^directive 

Sets switches to enable or disable MACRO features. If 
a directive has a logical opposite, you can use NO as a 
prefix to reverse the directive. The directives are: 

.ITABM - include spaces and tabs as part of passed 
arguments in macro call. 

•XTABM - strip leading and trailing spaces and tabs 
from passed arguments in macro call. .XTABM is 
the default setting. 

MACMPD - match paired delimiters in macro call. MACMPD 

is the default for assembly. It implies .XTABM 

and disables .ITABM. Using .DIRECTIVE NO MACMPD 

disables all quoting characters except angle 

brackets in macro arguments, and offers you a 
choice of .ITABM or .XTABM. 

LITLST - list all binary code for literals in-line. 

FLBLST - list only first line of binary code for 
multiline text. NO FLBLST is the default. 



.OKOVL - allow overflow for arithmetic and for 
pseudo-ops DEC, EXP, and OCT. 



the 



EXAMPLES 

COMMON 
ERRORS 



.EROVL - give an N error for arithmetic overflow. 
.EROVL is the default. 

MACPRF - prefer macro definition of symbol over other 
definitions of the same symbol. This does not 
affect the searching of .UNV files. 

SECOND - suppress source listing for failing 

conditional assembly. The lines containing the 

opening and closing angle brackets are not 
suppressed. 

.NOBIN - do not generate binary (.REL) file. 

KAIO - enter KAIO as CPU type in header block of binary 
file. 

KIIO - enter KIIO as CPU type in header block of binary 
file. 

KLIO - enter KLlO as CPU type in header block of binary 
file. 

♦DIRECTIVE MACMPDf .NOBIN 

Using NO with a directive that does not have a logical 
opposite. 
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PSEDDO-OPS 




FORMAT 



FUNCTION 



END expression 

expression = an optional operand that specifies the 
address of the first instruction to be executed; 
can be EXTERNAL. 

Must be the last statement in a MACRO program. 
Statements after END are ignored. The starting address 
is optional and normally is given only in the main 
program. (Since subprograms are called from the main 
program, they need not specify a starting address.) 

When the assembler first encounters an END statement, 
it terminates Pass 1 and begins Pass 2. The END 
terminates Pass 2 on the second encounter, after which 
the assembler simulates XLISTed LIT and VAR statements 
beginning at the current location. (In a PSECTed 
program, the LIT and VAR statements are simulated for 
each PSECT.) 



EXAMPLES 



END START 



START is a label at the starting address. 

OPTIONAL Use the END statement to specify a transfer word in 
NOTATIONS some output file formats. (See pseudo-ops RIM, RIMIO, 
and RIMIOB in Appendix E.) 



RELATED 
PSEUDO-OPS 



PRGEND 



COMMON 
ERRORS 



Failing to end a text string or literal with a 
closing delimiter; MACRO cannot see the END statement. 

Including an END statement in a source file when it is 
not the last file in a group of files you want 
assembled as a single program. 

Closing the input file immediately after the characters 
"END" with no following carriage return. 
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PSEODO-OPS 



•ENDPS 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



.ENDPS 

Suspends use of the relocation counter associated with 
the current PSECT. If the current PSECT is nested in 
other PSECTs, the relocation counter for the next outer 
PSECT is activated. Otherwise, the relocation counter 
for the blank PSECT is activated. 

MACRO generates a REL Block Type 22. (See the LINK 
Reference Manual. ) 

For a complete discussion of PSECTs and their handling, 
see Section 9.1.3. 

Give the name of the current PSECT with the .ENDPS 
pseudo-op. For example, 

♦ENDPS A 

causes MACRO to verify that A is the name of the 
current PSECT; if not, an error message is issued. 

LOC, .ORG, .PSECT, RELOC , TWOSEG 
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PSEUDO-OPS 



ENTRY 



FORMAT 



ENTRY symbol, ... ^symbol 

symbol = name of an entry point 
subroutine. 



m 



library 



FUNCTION 



Defines each symbol in the list following the ENTRY 
pseudo-op as an INTERNAL symbol and places them in a 
REL Block Type 4 at the beginning of the .REL output 
file. If this .REL file is later included in an 
indexed library of subroutines, then the symbol will 
also be included in a REL Block Type 14 at the 
beginning of the library. (Except for this, ENTRY is 
equivalent to INTERN.) 

If LINK is in library search mode, a subroutine will be 
loaded if the program to be executed contains an 
undefined global symbol that matches a name in the 
library entry list for that program. 

Since library subroutines are external to programs 
using them, the calling program must list them in 
EXTERN statements. 



EXAMPLES 



If the MATRIX subroutine is a library subroutine, 
must contain the statement 



it 



ENTRY MATRIX 

in order to make the symbol MATRIX available to other 
programs. In addition, it must define the symbol 
MATRIX as a label at the address where execution of the 
call is to begin: 



RELATED 
PSEUDO-OPS 



matrix: 

intern, extern 



COMMON 
ERRORS 



Not defining the symbol in the program. 

Purging an ENTRY symbol in Pass 2 only. The ENTRY 
symbol is normally output at the beginning of Pass 2; 
a PURGE of an ENTRY symbol must occur in Pass 1 to be 
effective. 
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PSEUDO-OPS 



EXP 



FORMAT 
FUNCTION 

EXAMPLES 



EXP expression, ... ^expression 

Enters the value of each expression (in the current 
radix) in a fullword of code. 



000003 
000101 
000004 
000002 

000000 000003 

000000 000004 

000000 000101 

000000 000101 

000000 000364 



X=3 

HALF=101 

B=4 

A=2 

EXP X>4»'^D65fHALF»B+362-A 



RELATED 
PSEUDO-OPS 



DEC, OCT 
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PSEUDO-OPS 



EXTERN 



FORMAT 
FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



EXTERN symbol, ... ,symbol 

Identifies symbols as being defined in other programs. 
EXTERNAL symbols cannot be defined within the current 
program. 

At load time, the value of an EXTERNAL symbol is 
resolved by LINK if you load a module that defines the 
symbol as an INTERNAL symbol. (If you do not load such 
a module, LINK gives an error message for the undefined 
EXTERNAL symbol.) 

An EXTERNAL symbol cannot be used for any program 
values affecting address assignment (such as arguments 
to LOC or RELOC) . 

For a discussion of global symbols and their resolution 
by LINK, see Section 2.4.5.2. 

EXTERN SORT > CUBE » TYPE 

Suffix ## to the symbol. This declares the symbol 
EXTERNAL, and eliminates the need for the EXTERN 
pseudo-op. Most programmers who use the ## notation do 
so at all occurrences of the symbol to show at each 
site that the symbol is EXTERNAL. 

For example, the two statements 

EXTERN A 
ATW0=A*2 

can be simplified to 

ATU0=A*#*2 

INTERN, ENTRY, UNIVERSAL 



Attempting to declare a symbol 
first use has made it local (by 
(by declaration) . 



as EXTERNAL after its 
default) or INTERNAL 



Declaring a symbol as EXTERNAL in a program that 
searches a UNIVERSAL file that gives a conflicting 
definition. 
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PSEUDO-OPS 



. HWFRMT 



FORMAT 

FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



.HWFRMT 

Causes binary code to be listed in halfword format 

200 01 02 000002 

200042 000002 

Use the /G switch described in Table 7-1. 

.MFRMT 



MOVE 1>2<2> 
♦HWFRMT 
MOVE 1»2<2) 
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PSEUDO-OPS 



.IF 



FORMAT 
FUNCTION 



.IF expression, qualif ier ,<code> 

Gives criterion and code for conditional assembly. The 
code is assembled if: 



qualifier is 

ABSOLUTE 

ASSIGNMENT 

ENTRY 

EXTERNAL 

INTERNAL 

GLOBAL 

LABEL 

LOCAL 

LRELOCATABLE 

MACRO 

NEEDED 

NUMERIC 

OPCODE 

OPDEF 

REFERENCED 

RELOCATABLE 

RRELOCATABLE 

SYMBOL 

SYNONYM 



AND 



expression is 



absolute 

a direct-assignment symbol 

a symbol given in ENTRY pseudo-op 

an EXTERNAL symbol 

an INTERNAL or ENTRY symbol 

a global symbol 

a label 

a local symbol 

a lefthalf relocatable symbol 

a macro name 

an undefined but referenced symbol 

numeric 

an opcode 

a symbol defined by OPDEF pseudo-op 

a symbol already in the symbol table 

a relocatable symbol 

a righthalf relocatable symbol 

a symbol (instead of a number) 

a symbol defined by SYN pseudo-op 



NOTE 

If the expression has different properties in 
Pass 1 and Pass 2, the number of words of code 
generated may be different for. each pass. 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



♦IF F00» MACRO r<FOO> 

Abbreviate qualifier up to unique initial letters. 
For example, you can abbreviate OPCODE to OPC, but not 
to OP, since OPDEF has the same first two letters. 

Omit the comma preceding the left angle bracket. 

.DIRECTIVE SECOND, .IFN, IFx group 

Omitting the comma between expression and qualifier. 

Mismatching angle brackets. 

Misplacing the .IF statement in such a way that the 

property given by the qualifier is different in Pass 1 

and Pass 2. For example, the following code generates 
phase errors in Pass 2: 

♦ IF FOO » OPDEF f < JFCL> 

opdef f00cjrst3 
nxtlab: end 
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PSEDDO-OPS 



.IFN 



FORMAT 
FUNCTION 



,IFN expressiorirqualif ier ,<code> 

Gives criterion and code for conditional assembly. The 
code is assembled if; 



qualifier is 

ABSOLUTE 

ASSIGNMENT 

ENTRY 

EXTERNAL 

INTERNAL 

GLOBAL 

LABEL 

LOCAL 

LRELOCATABLE 

MACRO 

NEEDED 

NUMERIC 

OPCODE 

OPDEF 

REFERENCED 

RELOCATABLE 

RRELOCATABLE 

SYMBOL 

SYNONYM 



AND 



expression IS NOT 



absolute 

a direct-assignment symbol 

a symbol given in ENTRY pseudo-op 

an EXTERNAL symbol 

an INTERNAL or ENTRY symbol 

a global symbol 

a label 

a local symbol 

a lefthalf. relocatable symbol 

a macro name 

an undefined but referenced symbol 

numeric 

an opcode 

a symbol defined by OPDEF pseudo-op 

a symbol already in the symbol table 

a relocatable symbol 

a righthalf relocatable symbol 

a symbol (instead of a number) 

a symbol defined by SYN pseudo-op 



NOTE 

If the expression has different properties in 
Pass 1 and Pass 2, the number of words of code 
generated may be different for each pass. 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



♦ IFN F00» OPDEF »<OPriEF F00C270B8D> 

Abbreviate qualifier up to unique initial letters. For 
example, OPCODE can be abbreviated to OPC, but not to 
OP, since OPDEF has the same first two letters. 

Omit the comma preceding the left angle bracket. 

.DIRECTIVE SECOND, .IF, IFx group 

Omitting the comma between expression and qualifier. 

Mismatching angle brackets. 

Misplacing the .IFN statement in such a way that the 

property given by the qualifier is different in Pass 1 

and Pass 2. For example, the following code generates 
phase errors in Pass 2: 

♦ IFN FOO y OPDEF r < JFCL> 

opdef f00cjrst3 
nxtlab: end 
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PSEUDO-OPS 



IFx group 



FUNCTION Gives criterion and code for conditional assembly. A 
symbol or expression used to define the conditions for 
assembly must be defined before MACRO reaches the 
conditional statement. If the value of such a symbol 
or expression is not the same on both assembly passes, 
a different number of words of code may be generated, 
and a phase error can occur. 

The forms of the IF pseudo-op are listed below; in the 
first six forms, n is the value of the given 
expression. 

IFE expression, <code> - assemble code if n-0. 

IFN expression, <code> - assemble code if n+0. 

IFG expression, <code> - assemble code if n>0. 

IFGE expression, <code> - assemble code if n>0. 

IFL expression, <code> - assemble code if n<0. 

IFLE expression, <code> - assemble code if n<0. 

IFl <code> - assemble code on Pass 1. 

IF2 <code> - assemble code on Pass 2. 

IFDEF symbol, <code> - assemble code if the symbol is 
defined as user-defined, an opcode, or a 
pseudo-op. 

IFNDEF symbol ,<code> - assemble code if the symbol is 
not defined as user-defined, an opcode, or a 
pseudo-op. Code is also assembled if the symbol 
has been referenced, but is not yet defined. This 
can occur during Pass 1. 

IFIDN <stringl><string2>,<code> - assemble code if the 
strings are identical. 

IFDIF <stringl><string2>,<code> - assemble code if the 
strings are different. 

NOTES 

1. For IFIDN and IFDIF, the assembler 
compares the two strings (interpreted 
as ASCII) character by character. 

2. The IFIDN and IFDIF pseudo-ops usually 
appear in macro definitions, where one 
or both strings are dummy-arguments. 



(Continued on next page) 
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PSEODO-OPS 



IFx group (Cont.) 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IFB <string> ,<code> - assemble code if the string 
contains only blanks and tabs. 

IFNB <string>,<code> - assemble code if the string does 
not contain only blanks and tabs. 

%%CC==%/iCC+l ? Increment character count 
IFG /!:%CC-5r<%%CC==0 J Word overflowed? 
Z%WC==ZZUC+i::- JYesr to next word 

Omit angle brackets enclosing code for single-line 
conditionals. 

Omit the comma preceding the code if the code is 
enclosed in angle brackets. 

For IFIDN, IFDIF, IFB, and IFNB only: use a nonblank, 
nontab character other than < as the initial and 
terminal delimiters for a string (as in pseudo-ops 
ASCII and ASCIZ) . You can then include angle brackets 
in the string. 

.DIRECTIVE SECOND, .IF, . IFN 



Comparison string too large (A error) . 

Mismatched angle brackets. 

EXTERNAL symbol used for comparison (E error) . 

String not properly delimited. 

Missing comma with single-line conditional. 
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PSEUDO-OPS 



INTEGER 



FORMAT 



FUNCTION 



EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



INTEGER symbol, ... ^symbol 

symbol = the name of a location to be reserved. 

Reserves storage locations at the end of the program on 
a one-per-given-symbol basis. The symbols are 
equivalent to variable symbols. 

For a two-segment program, INTEGER storage must be in 
the low segment. 

INTEGER ArB»C 

Reserve a single storage location by suffixing a number 
sign (#) to a symbol in the operand field. For 
example, 

ADD 3 r TEMP* 

is equivalent to 

INTEGER TEMP 
ADD 3 r TEMP 

ARRAY, BLOCK, .COMMON, VAR 
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PSEDDO-OPS 



INTERN 



FORMAT 
FUNCTION 



INTERN symbol , . . . , symbol 

Declares each given symbol to be INTERNAL global; 
therefore its definition, which must be in the current 
program, is available to other programs at load time. 
Each such symbol must be defined as a label , a 
variable, or a direct-assignment symbol. 

MACRO builds a list of symbol definitions that will be 
available to other programs at load time. 

OPDEF symbols can be declared INTERNAL, and thus be 
made available to other programs at load time. 
However, if the current program has another symbol 
(besides the OPDEF symbol) of the same name, the 
INTERNAL declaration will apply to that symbol rather 
than to the OPDEF symbol. 



EXAMPLES 

OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



INTERN SQUARE rCBR00TfTYPE2 



TAG: : 

VALUE= rexpression 

EXTERN, ENTRY 



; INTERNAL label 

; INTERNAL direct assignment 



Failing to define an INTERNAL symbol in the current 
program. 

Using INTERN for a library entry point (when ENTRY is 
required) . 
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PSEDDO-OPS 



lOWD 



FORMAT 



FUNCTION 



EXAMPLES 



lOWD expl,exp2 

expl, exp2 = expressions. 

Generates one I/O transfer word in a special format for 
use in BLKI and BLKO and all five pushdown instructions 
(ADJSP, PUSH, POP, PUSHJ, POPJ) . The left half of the 
assembled word contains the 2's complement of the value 
of expl, and the right half contains the value exp2-l. 

The following line shows how lOWD 6,"D256 places -6 
(octal 777772) in the left halfword and 256 (octal 377) 
in the right halfword: 



777772 000377 



lOUD 6»"D256 



The following lines show lOWD STL,STK used in a 
literal. The LIT pseudo-op then shows the code 
generated in the literal pool. 



000017 
000001 
000100 

200 17 00 001053' 
261 17 00 000001 
254 00 00 001054' 



P==17 
AC1==1 
STL==100 
STK: block STL 

MOVE PfCIOWD STL»STK3 
PUSH PrACl 
JRST END 



LIT 
777700 000001 
104 00 00 000170 END: HALTF 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



XWD -expl,exp2-l 

-expl, ,exp2-l 

Using a relocatable expression for expl (R error) . 
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PSEUDO-OPS 



IRP 



FORMAT 



FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IRP darg,<code> 

darg = one of the dummy-arguments of the enclosing 
macro definition. (You can use IRP only in the 
body of a macro definition.) 

Generates one expansion of code for each subargument of 
the string that replaces darg. Each occurrence of darg 
within the expansion is replaced by the subargument 
currently controlling the expansion. (See Section 
5.6.) 

Concatenation and line continuation are not allowed 
across end-of-IRP, since a carriage return and linefeed 
are appended to each expansion. See the example below. 



000000 
000001 
000002 
000003 
000004 



201 02 00 000000 

140 02 00 000003 
140 02 00 000004 
140 02 00 000000 

202 02 00 000001 

IRPC, STOPI 



LALL 

Z=0 

ANSWER=1 

Q=2 

X=3 

Y=4 

DEFINE SUMCAfBX 
MOVEI QrO 
IRP Af<ADD QrA: 
MOVEM QtB 

SUM <<X»Y»Z>> ANSWER)-^ 
MOVEI QrO 
IRP 

ADD QrX 

ADD QrY 

ADD Q»Z 

MOVEM a r ANSWER 



IRP NOT IN A MACRO (A ERROR) . 
Argument is not a dummy symbol (A error) . 
Argument is a created symbol (A error) . 
Mismatched angle brackets. 
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PSEUDO-OPS 



IRPG 



FORMAT 



FUNCTION 



IRPC darg,<code> 

darg = one of the dummy-arguments of the enclosing 
macro definition. (IRPC can only be used in the 
body of a macro definition.) 

Generates one expansion of code for each character of 
the string that replaces darg. Each occurrence of darg 
within the expansion is replaced by the character 
currently controlling the expansion. (See Section 
5.6.) 

Concatenation and line continuation are not allowed 

across end-of-IRPC, since a carriage return and 

linefeed are appended to each expansion. See the 
example below. 



EXAMPLES 



RELATED 
PSEUOD-OPS 



123 000 000 000 000 

124 000 000 000 000 
122 000 000 000 000 
111 000 000 000 000 
116 000 000 000 000 
107 000 000 000 000 

IRP, STOPI 



DEFINE A (B XI RFC Br<ASCIZ \B\: 

A(STRING)"IRFC 

ASCIZ \S\ 

ASCIZ \T\ 

ASCIZ \R\ 

ASCIZ \I\ 

ASCIZ \N\ 

ASCIZ \G\ 



COMMON 
ERRORS 



IRPC NOT IN A MACRO (A ERROR) . 
Argument is not a dummy symbol (A error) . 
Argument is a created symbol (A error). 
Mismatched angle brackets. 
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PSEUDO-OPS 



LALL 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



LALL 

Causes the assembler to print in the program listing 
file everything that is processed, including all text 
and macro expansions. Since XALL is the default, you 
must use LALL if you want full macro expansions listed. 
This can be helpful in debugging a program. 

LALL does not produce comments in a macro expansion if 
the comments are preceded by double semicolons (;;). 
This is because such comments are not stored. 

Use the /E switch described in Table 7-1. 



LIST, SALL, XALL, XLIST 
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PSEUDO-OPS 



.LINK 



FORMAT 



.LINK chain-number , store -address , chain-address 

chain-number = a positive integer expression that 
associates the link with others having the same 
number . 

store-address = a symbol giving the store address for 
this entry in the chain. 

chain-address = an optional integer expression giving 
the address of this entry in the chain. If you 
omit the chain-address, MACRO generates a and 
LINK uses the store-address as the chain-address. 



FUNCTION 



Generates static chains at load time. MACRO generates 
a REL Block Type 12. (See the LINK Reference Manual 
for a full discussion of LINK'S handling of these 
chains. ) 



EXAMPLES 



See the LINK Reference Manual (REL Block Type 12) for 
extensive examples of using .LINK and .LNKEND. 



RELATED 
PSEUDO-OPS 



.LNKEND 



COMMON 
ERRORS 



Chain-number not absolute (A error) . 

EXTERNAL expression for store-address or chain-address 
(E error) . 
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PSEDDO-OPS 



LIST 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



LIST 

Resumes listing following an XLIST statement. The LIST 
function is implicitly contained in the END statement. 

Use the /L switch described in Table 7-1. 



LALL, SALL, XALL, XLIST 
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PSEUDO-OPS 



LIT 



FORMAT 
FUNCTION 



LIT 

Assembles literals beginning at the current address. 
The literals assembled are those found since the 
previous LIT, or since the beginning of the program, 
whichever is later. The location counter is 
incremented by 1 for each word assembled. 



In a PSECTed program, LIT assembles 
the current PSECT. 



only literals in 



A literal found after the LIT is not affected. It will 
be assembled at the next following LIT, or at the END 
statement, whichever is earlier. 

At the END statement, unassembled literals are placed 
in open-ended storage after the end-of-program. If 
data is also to be entered in open-ended storage, 
literals stored there may be overwritten. (See 
Appendix F for a discussion of storage allocation.) 
This possibility is avoided by using LIT before the END 
statement. 

Assembling literals with LIT also produces a listing of 
their binary code. Literals unassembled at the END are 
XLISTed. 

Literals having the same value are collapsed in MACRO'S 
literal pool. Thus for the statements: 

PUSH PrCOD 
PUSH FrCOl 
MO'JEI AClfCASCIZ /TESTl/a 

the same address is shared by the two literals [0], and 
by the null word generated at the end of [ASCIZ 
/TESTl/] . Literal collapsing is suppressed for those 
literals that contain errors, undefined expressions, or 
EXTERNAL symbols. 



NOTES 



If the code immediately preceding a LIT 
does not cause a transfer of execution 
control to some other location, execution 
will "fall into" the literal pool, 
producing unpredictable results. 

In a file containing PRGEND pseudo-ops, 
only one LIT is permitted in each module 
before the last one. The last module 
(containing the END statement) , or any file 
without PRGENDs, can contain multiple LITs. 



(Continued on next page) 
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PSEODO-OPS 



LIT (Cont.) 



EXAMPLES 



400046' 200 00 00 400050' 

400047' 047 00 00 000041 

400050' 

400050' 000001 000003 



MOVE OrCXWD 1^33 

GETTAB Or 

LIT 



RELATED 
PSEUDO-OPS 



.DIRECTIVE LITLST, END, PRGEND, VAR 



COMMON 
ERRORS 



Assembling literals so that some are collapsed on Pass 
1, but not on Pass 2. For example, in the following 
lines, the literals [A] and [B] are collapsed on Pass 1 
since they have the same value; but on Pass 2 their 
values are different and they are not collapsed. This 
produces a phase error for the label FOO. 

IFlr<A=5 

B='5> 
IF2r<A=5 

B=4> 
MOVE ACrCA3 
MOVE AC»CB3 
LIT 

Foo: 

However, literals that have different values in Pass 1 
but the same value in Pass 2 do not produce a phase 
error* For example, the following code generates two 
words of literal storage in Pass 1. During Pass 2 the 
values of [A] and [B] are collapsed, but nevertheless 
MACRO generates two words of literal storage to avoid a 
phase error at the label FOO. 

MOVE AC1»CA3 
MOVE AClrCBD 
LIT 
A=5 
B=5 
FOO J 
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PSEDDO-OPS 



. LNKEND 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.LNKEND chain-number , store-address 

Ends a static chain generated at load time. See the 
LINK Reference Manual (REL Block Type 12) for extensive 
examples of using .LINK and .LNKEND.) 

.LINK 



Chain-^number not absolute (A error) . 

EXTERNAL expression for store-address (E error) . 
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PSEUDO-OPS 




FORMAT 



LOG expression 

expression = an optional operand whose value gives the 
address at which sequential address assignment is 
to continue. 



FUNCTION 



Sets the location counter to the value of the 
expression and begins assigning absolute addresses to 
the instructions and data following the LOG 
instruction. 



If no address is specified, the location counter is 
restored to its value previous to the last LOG 
pseudo-op or RELOC-RELOG sequence. (See example 
below.) If no previous LOG pseudo-op was encountered, 
the assumed address is 0. 

To switch to relocatable address mode, use the 
pseudo-op RELOG. If no argument is specified, RELOG 
(in this context) restores the location counter to its 
value previous to the LOG pseudo-op or LOG-LOG 
sequence. (An implicit RELOG begins each program.) 

If an entire program is to be assigned absolute 
locations, a LOG statement must precede all 
instructions and data. 

Note that, unlike RELOG-RELOG sequences, typically used 
to switch between segments in a two-segment program, 
LOG-LOG sequences cannot be successfully interrupted 
and then resumed. This is demonstrated in the example 
below. 



EXAMPLES 


400000' 




TWOSEG 400000 


9Set UF hised 




000000' 




RELOC 






^Back to lowsesi 




000010 




LOG 10 






J Set UP LOC-LOC 




000010 


000000 000001 


DEC 1»2 










000011 


000000 000002 












000100 




LOG 100 










000100 


000000 000003 


DEC 3fA 










000101 


000000 000004 












000012 




LOG 










000102 




LOG 










000000' 




RELOC 






r Resume RELOC- 
; RELOC 




rBut we 


can't resume LOG 


-LOC 










400000' 




RELOC 










000102 




LOG 










000102 




LOG 










400000' 




RELOC 






?But RELOC- 

r RELOC is fine 




000102 




LOG 








RELATED 


RELOG, 


.ORG, TWOSEG 










PSEUDO-OPS 














GOMMON 


Using an EXTERNAL expression for 


the 


address expression 


ERRORS 


(E error 


■) . 
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PSEUDO-OPS 



.MFRMT 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



.MFRMT 

Causes multiformat listing of binary code. The type of 
instruction assembled determines this format. (See 
Section 6.1.) .MFRMT is the default setting. 

Use the /F switch described in Table 7-1. 



.HFRMT 
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PSEUDO-OPS 



MLOFF 



FORMAT 
FUNCTION 



EXAMPLES 



MLOFF 

Terminates each literal at end-of-line even if no 
closing square bracket is found. This pseudo-op is 
intended only to maintain compatibility of programs 
written for very old versions of MACRO. 

This example shows how MLOFF can be used to interpret 
[1234 as [1234] . 



000000 
000000 



402001' 
402001' 



MLOFF 
C1234 
C12343 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



Use the /O switch described in Table 7-1. 



MLON 
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PSEUDO-OPS 




FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



MLON 

Suspends the effect of an earlier MLOFF pseudo-op, 
thereby enabling the use of multiline literals. MLON 
is the default setting. 

MLOFF 
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PSEUDO-OPS 



.NODDT 



FORMAT 
FUNCTION 

EXAMPLES 

OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.NODDT symbol, ... ,symbol 

Suppresses debugger output of each given symbol. Each 
symbol must have been previously defined. Symbols 
suppressed with .NODDT can include OPDEF symbols. 

♦NODDT CALL»PJRST»P 

Use == for direct-assignment symbols, (See Section 
2.4.2.2.) 

Use :! for label symbols. (See Section 2.4.2.1.) 

PURGE 



Using .NODDT with an undefined symbol argument. 
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PSEUDO-OPS 



NOSYM 



FORMAT 
FUNCTION 



NOSYM 

Suppresses listing of the symbol table in the program 
listing file. 

Suppressing the listing of symbol tables is useful for 
a library file containing many PRGENDs. 
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PSEDDO-OPS 



OCT 



FORMAT 
FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 



OCT expression, ... ^expression 

Defines the local radix for the line as octal; the 
value of each expression is entered in a fullword of 
code. The location counter is incremented by 1 for 
each expression. 



OCT l,2»20fl00 



000000 000001 

000000 000002 

000000 000020 

000000 000100 



Use the EXP pseudo-op and prefix "0 to each expression 
that must be evaluated in radix 8. In the example 
above, only the third and fourth expressions, "20,100," 
could have different evaluations in different radixes. 
Therefore an equivalent notation is: 



RELATED 
PSEUDO-OPS 



000000 000001 

000000 000002 

000000 000020 

000000 000100 

DEC, EXP, RADIX 



EXP 1»2»'"020»"0100 
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PSEUDO-OPS 



OPDEF 



FORMAT 
FUNCTION 



OPDEF symbol [expression] 

Defines the symbol as an operator equivalent to 
expression, giving the symbol a fullword value. When 
the operator is later used with operands, the 
accumulator fields are added, the indirect bits are 
ORed , the memory addresses are added, and the index 
register addresses are added. 

An OPDEF can be declared INTERNAL, using the INTERN 
pseudo-op. However, if a symbol of the same name 
exists, the INTERNAL declaration will apply only to 
that symbol, and not to the OPDEF. 



NOTES 



If you use a relocatable symbol in defining 
an OPDEF, the value of the symbol may not 
be the same for all references to the 
OPDEF. 

Though the expression portion of an OPDEF 
must be in square brackets, this use of the 
brackets is completely unrelated to 
literals or literal handling. 



EXAMPLES 



200062 000010 
200 02 1 04 000014 



OPDEF CAL CMOVE 1»@SYM(2)3 
CAL lfB0L(2) 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



The CAL statement is equivalent to: 

200 02 1 04 000014 MOVE 2reSYM+B0L(4) 

DEFINE, SYN 

OPDEF of macroname or SYN symbol (A error) . 

No code generated by statement in square brackets (A 
error) . 

Missing square brackets (A error) . 
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PSEUDO-OPS 




FORMAT 
FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.ORG address 

Sets the location counter to the address and causes the 
assembler to assign absolute or relocatable addresses 
depending on the mode of the argument. If A is 
relocatable, then .ORG A is equivalent to RELOC A; if 
A is absolute, then .ORG A is equivalent to LOC A. 

.ORG with no address sets the location counter to the 
value it had immediately before the last LOC, RELOC, or 
.ORG. 



000000 



400000' 



000000 



ABSADl : 
ABSAD2: 



400000' 

400000' RELADIJ 

000000' 

000000' RELAn2: 

000100 

000100 

400100 

400100 

000100 



400000 
400100 
400000 



RELOC 400000 
RELOC 
LOC 100 
LOC 400100 
LOC ABSADl 

RELOC RELADl 

♦ORG ABSAD2 

♦ ORG 



ORG RELAD2 



♦ ORG 



♦ ORG 



LOC, RELOC, TWOSEG 



J Set UP some labels 



J Set counter to ABSADl 
3rid be^in absolute 
address assi^nnrient^ 

Set counter to RELADl 
and be<^in relative 
address assignments 

Set counter to ABSAD2 
and bedin absolute 
address assignment* 

Set counter to value 
immediately before 
last LOCj- RELOCr or 
♦ ORGr and beisin 
address assignment 
in appropriate mode* 

Set counter to RELAD2 
and bedin absolute 
address assignment ♦ 

Set counter to value 
immediately before 
last LOC> RELOCr or 
♦ORGf and be^in 
address assignment 
in appropriate mode^ 

Set counter to value 
immediately before 
last LOC» RELOCr or 
♦ORGy and bed in 
address assignment 
in appropriate mode* 



Using an EXTERNAL symbol or complex EXTERNAL expression 
for the address expression. 
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PSEDDO-OPS 



PAGE 



FORMAT PAGE 

FUNCTION Causes the assembler to list the current line and then 
skip to the top of the next listing page. The subpage 
number is incremented, but the page number is not. 

OPTIONAL A formfeed character (CTRL/L) in the input text 
NOTATIONS has a similar effect, but increments the page number 
and resets the subpage number. 
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PSEDDO-OPS 



PASS 2 



FORMAT 
FUNCTION 



EXAMPLES 



PASS 2 

Switches the assembler to Pass 2 processing for the 

remaining code. All code preceding this statement will 

have been processed by Pass 1 only; all following code 
by Pass 2 only. 

You can use PASS2 to reduce assembly time during 
debugging; you can also use PASS2 to omit the second 
pass for a UNIVERSAL file containing only symbol 
definitions (OPDEFs, macros, and direct assignments). 

Testing a macro defined in the Pass 1 portion: 

IFE NONr< 

PRINTX THORRIBLE ERROR 

PASS2 

END 



stops assembly if NON = 0. 
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PSEUDO-OPS 



PHASE 



FORMAT 



PHASE address 



FUNCTION 



address = an integer expression; 
symbol . 



cannot be an EXTERNAL 



Assembles part of a program so that it c 
other locations for execution. To us 
the subroutine is assembled at sequenti 
or absolute addresses along with th 
program, but the first statement before 
is PHASE, followed by the address of the 
of the block into which the subroutine i 
prior to execution. All address ass 
subroutine are in relation to the add 
The subroutine is terminated by DEPHASE, 
the location counter. 



an be moved to 
e this feature, 
al relocatable 
e rest of the 
the subroutine 

first location 
s to be moved 
ignments in the 
ress argument. 

which restores 



EXAMPLES 



In the following example, which is the central loop in 
a matrix inversion, a block transfer instruction moves 
the subroutine LOOP into accumulators 11 to 15 for 
execution. (This results in faster execution on KAIO 
and KIIO processors.) 



002000' 200 00 00 402002'MAIN: 

002001' 251 00 00 000015 

002002' 254 00 00 000011 
000011 LODPX: 

000011 210 02 03 000002 LOOP: 

000012 160 02 00 000100 

000013 142 02 04 000002 

000014 365 03 00 000011 

000015 254 00 00 002000' 
002010' 



MOVE CXWn LOOPXfLOOR] 

BLT LOOP+4 

JRST LOOP 

PHASE 11 

MOVN ACrA(X) 

FMP AC^MPYR 

FADM ACrA(Y) 

SO JOE Xf.-3 

JRST MAIN 

DEPHASE 



RELATED 
PSEUDO-OPS 



The label LOOP represents accumulator 11, and the .-3 
in the SOJGE instruction represents accumulator 11. 

Note that the code inside the PHASE-to-DEPHASE program 
segment is loaded into the address following the 
previous relocatable code; all labels inside the 
segment, however, have the address corresponding to the 
phase address. Thus the phased code, if it contains 
control transfers other than skips, cannot be executed 
until it has been moved (for example, by a BLT 
instruction) to the address for which it was assembled. 

DEPHASE 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address (E error) . 
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PSEUDO-OPS 



POINT 



FORMAT 
FUNCTION 



POINT bytesize, address, bitplace 

Generates a byte pointer word for use with the machine 
language mnemonics ADJBP, LDB, IBP, ILDB, and IDBP. 

Bytesize gives the decimal number of bits in the byte, 
and is assembled in bits 6 to 11 of the storage word. 
Address_gives the location of the byte word, and is 
assembled in bits 13 to 35. Bit£l^ii£ gives the 
position (in decimal) of the rightmost bit of the byte. 
MACRO places the value 35 minus bitplace in bits to 5 
of the storage word. 

If the address is indirect, bit 13 is set. If the 
address is indexed, the index is placed in bits 14 to 
17. The default bytesize is 0. The default bitplace 
is -1, so that the byte increment instructions IBP, 
ILDB, and IDBP will begin at the left of the address 
word . 



EXAMPLES 



36 06 00 000000 
44 06 00 000100 



POINT 670t5 
POINT 6fl00 



COMMON 
ERRORS 



Bytesize or bitplace not given in decimal. 
Bytesize or bitplace not absolute. 
Bytesize or bitplace EXTERNAL. 
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PSEDDO-OPS 



PRGEND 



FORMAT 
FUNCTION 



PRGEND 

Replaces the END statement for all except the last 
program of a multiprogram assembly. PRGEND closes the 
local symbol table for the current module. 

You can use PRGEND to place several small programs into 
one file to save space and disk accesses. The 
resulting binary file can be loaded in search mode. 
(See the LINK Reference Manual. ) 

Using PRGEND requires extra memory for assembly, since 
the tables for each program must be saved for Pass 2. 
Functionally, however, PRGEND is identical to END, 
except that PRGEND does not end the current assembly 
pass. 



NOTE 



1. PRGEND is not allowed in macros or PSECTs. 

2. PRGEND clears the TWOSEG pseudo-op. 

3. Like END, PRGEND causes assembly of all 
unassembled literals and variable symbols. 

4. In a file containing PRGENDs, using more 
than one LIT pseudo-op in any but the last 
program produces unpredictable results. 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



Give an argument with PRGEND, specifying the start 
address for the program. See the END pseudo-op for a 
discussion of this argument and its meaning. 

END, LIT, VAR 



Failing to end a text string, REPEAT, conditional code, 
DEFINE, or literal with a closing delimiter; MACRO 
cannot see any following PRGEND or END. 

Confusing multiprogram and multifile assemblies. A 
multiprogram assembly involves multiple programs 
separated by PRGENDs. A multifile assembly always 
involves multiple files separated by end-of-file. The 
two types of assemblies are not mutually exclusive. 
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PSEDDO-OPS 



PRINTX 



FORMAT 
FUNCTION 



EXAMPLES 



PRINTX text 

Causes text to be output during assembly. On Pass 1 
the text is output to the terminal and the listing 
device. On Pass 2 the text is output to the terminal, 
but only if the terminal is not the listing device. 

PRINTX is frequently used to output conditional 
information and, in very long assemblies, to report 
progress of the assembler through Pass 1. 

PRINTX ASSEMBLER HAS REACHED POINT NOWGO 

IFGE ♦-•1000r<PRINTX CODE MORE THAN 1P> 
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PSEDDO-OPS 



PSECT 



FORMAT 



FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 



, PSECT name/attribute, origin 

name = a valid symbol giving the name of the PSECT. 

attribute = either CONCATENATE or OVERLAID. 

origin = an expression giving an address for the PSECT 
origin. 

Specifies the relocation counter to be used for the 
code following. MACRO generates a REL Block Type 23. 
(See the LINK Reference Manual .) 

Do not use PRGEND and .PSECT in the same file. MACRO 
will treat the first PRGEND as an END statement and 
ignore any following source code. 

For a complete discussion of PSECTS and their handling, 
see Section 9.1.3. 

♦PSECT A/CONCATENATE »0 

♦PSECT FIRST/OVERLAIDrlOOO 

Omit attribute (defaults to CONCATENATE) . 

.ENDPS, LOC, .ORG, RELOC, TWOSEG 

Using TWOSEG and .PSECT in the same module. 
Using HISEG and .PSECT in the same module. 
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PSEUDO-OPS 



PURGE 



FORMAT 



FUNCTION 



PURGE symbol , . . . , symbol 

symbol = an assigned symbol, a label, an operator, or a 
macro name. 

Deletes symbols from the symbol tables. Normally used 
at the end of a program to conserve storage and to 
delete symbols for the debugger. Purged symbol table 
space is reused by the assembler. 

If you use the same symbol for both a macro name or 
OPDEF and a label, a PURGE statement deletes the macro 
name or OPDEF. Repeating the instruction then purges 
the label. 

Purging a symbol that is EXTERNAL or undefined 
suppresses any error messages associated with it. 



EXAMPLES 



000040 000001 



label: iri 

PURGE LABEL 



RELATED 
PSEUDO-OPS 



.NODDT, XPUNGE 
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PSEUDO-OPS 



RADIX 



FORMAT 



FUNCTION 



EXAMPLES 



RADIX expression 

expression = decimal value from 2 to 10 

Sets the radix to the value of expression. An implicit 
RADIX 8 statement begins every MACRO program. 

All numerical expressions that follow (up to the next 
RADIX pseudo-op) are interpreted in the given radix 
unless another local radix is indicated. (A different 
local radix for the line can be indicated by the DEC or 
OCT pseudo-ops; a different local radix for an 
expression can be indicated by "B, "D, or "0. See 
Section 2.2.2.) 

Ordinarily, numbers outside the range of the given 
radix are not interpreted. For example, in radix 8, 
the number 99 causes an error. However, a single-digit 
number is interpreted in any case. For example, in 
radix 8, the number 9 is recognized as octal 11. 



000000 000012 
000000 000010 



RADIX 10 
EXP 10 
RADIX 8 
EXP 10 



OPTIONAL Use one of the following prefixes to change the radix 
NOTATIONS for a single expression: "B for binary, ''0 for octal, 
''D for decimal. 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



DEC, OCT 

Using a relocatable expression (A error). 

Using an external expression (E error) . 

Giving a radix argument not in the range 2 to 10 
decimal (A error) . 

Misusing numbers in a given radix; for example, in the 
statements 

RADIX 10 
RELOC 400000 

MACRO treats the number 400000 as decimal. 
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PSEDDO-OPS 



RADIX50 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RADIX50 code, symbol 

Packs the symbol into bits 4 to 35 of the storage word, 
with the code in bits to 3. 

The "50" in RADIX50 is octal, so that the radix in 
decimal is 40. The 40 characters permitted in symbols 
are the "digits" of the RADIX50 symbol expression. 
Thus a symbol is seen by RADIX50 as a "6-digit" number 
in base 40, converted to binary, and placed in bits 4 
to 35 in storage. 

The code expression for RADIX50 is a number in the 
range to 74 octal. Its binary equivalent should end 
with two zeros (that is, the octal should end with or 
4), since the two low-order bits will not be stored. 
The four high-order bits are placed in bits to 3 in 
storage. 

See Appendix A for the octal values of RADIX50 
characters. 

126633 472376 RADIX50 lOrSYMBOL 
466633 472376 RADIX50 44rSYMB0L 

The mnemonic SQUOZE can be used in place of RADIX50. 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



RADIX50 , symbol (code is taken as zero) . 
SQUOZE 

RADIX50 code not absolute (A error) . 

RADIX50 code does not end with or 4 (Q error) . 
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PSEDDO-OPS 



RELOC 



FORMAT 



RELOC expression 

expression = an optional operand that specifies the 
address at which sequential address assignment is 
to continue. 



FUNCTION 



Sets the location counter to the value of extression, 
and begins assigning relocatable addresses to the 
instructions and data that follow. 



In a PSECTed program, RELOC sets the location counter 
for the current PSECT. 

If no address is specified, the location counter is 
restored to its value before the last RELOC, or before 
the last LOC-LOC sequence, whichever is later. (See 
the first example below.) If no previous RELOC or 
LOC-LOC sequence was encountered, the location counter 
is set to 0. 

An implicit RELOC begins every MACRO program. To 
switch to absolute address mode, use the pseudo-op LOC. 

Note that RELOC-RELOC sequences (typically used to 
switch between segments in a two-segment program) can 
be interrupted and then resumed. This is demonstrated 
in the first example below. 



EXAMPLES 



400000' 

000000' RELOC 

000000' 000000 000001 DEC lr2 

000001' 000000 000002 

400000' RELOC 

400000' 255 00 00 000000 JFCL 

000137 LOC 137 

000137 000100 000001 XUD lOOrl 

400001' RELOC 

400001' 254 00 00 400000' JRST .-1 

000002' RELOC 



TUOSEG 400000 ?Set up hise^ 



?B3ck to lowse^ 



rBack to hise^ 

JDeposit version 
r in sbsolute 137 

rBack to hised 
r where left off 

rBack to lowse^ 



RELATED 
PSEUDO-OPS 



LOC, .ORG, TWOSEG 



(Continued on next page) 
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PSEUDO-OPS 



RELOC (Cont.) 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address. 



Returning to the wrong segment when using RELOC with 
TWOSEG. The last four lines of the following example 
show how this can occur: 



400000' 






TWOSEG 


400000' 






RELOC 400000 


000000' 






RELOC 


400000' 






RELOC 


400000' 


000000 


000001 


EXP 1^2 


400001' 


000000 


000002 




000000' 






RELOC 


000000' 


000000 


000003 


EXP 3»4 


000001 ' 


000000 


000004 




400002' 






RELOC 


400000' 






RELOC 400000 


400002' 






RELOC 


400000' 






RELOC 


400000' 


000000 


000001 


EXP 1 



Sets first RELOC 

counter to 

400000' 
Saves 400000' r 

sets to 000000' 
Sw3ps counters 
Enter values here 

Swaps a^ain 
More values here 

Swaps ai^ain 
Lost counter 

to 000002' 
Swaps adain 
Swaps a^ain 
Overwrites 400000' 
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PSEUDO-OPS 



REMARK 



FORMAT 

FUNCTION 

EXAMPLES 

OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



REMARK text 

Text is a comment. 

REMARK I CAN SAY ANYTHING HERE* 

A comment line can also begin with a semicolon 

COMMENT 



Continuing REMARK text to next line without using the 
continuation character (CTRL/underscore) . 
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PSEUDO-OPS 



REPEAT 



FORMAT 



FUNCTION 



REPEAT expression, <code> 

expression = the repeat index, which gives the number 
of times to repeat assembly of the code given; 
the repeat index can be any expression having a 
nonnegative integer value. 

Generates the code given in angle brackets n times. 
REPEAT statements can be nested to any level. 

Line continuation is not allowed across end-of -REPEAT, 
since a carriage return and linefeed are appended to 
each expansion of the code. 

Note that REPEAT 0,<code> is logically equivalent to a 
false conditional, and REPEAT l,<code> is logically 
equivalent to a true conditional. 



EXAMPLES 



000000 



002020' 000000 000000 

000001 
002021' 000000 000001 

000002 
002022' 000000 000002 

000003 
002023' 000000 000003 

000004 



COUNT=0 

table: repeat 4»<C0UNT 

C0UNT=C0UNT+1> 

COUNT 

C0UNT=C0UNT+1 

COUNT 

C0UNT=C0UNT+1 

COUNT 

C0UNT=C0UNT+1 

COUNT 

C0UNT=--C0UNT+1 



REPEAT 3f<*> 
002024' 000000 002024' ♦ 
002025' 000000 002025' ♦ 
002026' 000000 002026' . 



RELATED 
PSEUDO-OPS 



DEFINE, IRP, IPRC 



COMMON 
ERRORS 



No comma after n (A error) . 

Using an EXTERNAL symbol or complex EXTERNAL expression 
as the repeat index. 

Mismatching angle brackets. 
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PSEUDO-OPS 



.REQUEST 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



.REQUEST- filespec 

Gauses the specified file to be loaded only to satisfy 
a global request; that is, the file is loaded in 
library search mode. (See Chapter 7 for a discussion 
of files.) 

The filespec must not include a file type. If you 
specify a directory, the specification must be a 
project-programmer number, not a directory name. 

MACRO generates a REL Block Type 17. (See the LINK 
Reference Manual . ) 

♦REQUEST DSK: MACROS 
♦REQUEST MACROS 

DSK: is the default device. 

Your connected directory at load time is the default 
directory. 

.REQUIRE, .TEXT 
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PSEDDO-OPS 



.REQUIRE 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



•REQUIRE filespec 

Causes the specified file to be loaded automatically, 
independent of any global requests, (See Chapter 7 for 
discussion of files.) 

The filespec must not include a file type. If you 
specify a directory, the specification must be a 
project-programmer number, not a directory name. 

MACRO generates a REL Block Type 16. (See the LINK 
Reference Manual. ) 

♦REQUIRE DSK: MACROS 
♦REQUIRE MACROS 
♦REQUIRE SYS:MACREL 

DSK: is the default device. 

Your connected directory at load time is the default 
directory. 

.REQUEST, .TEXT 
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PSEUDO-OPS 




FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 

RELATED 
PSEUDO-OPS 



SALL 

Causes suppression of all macro and repeat expansions 
and their text; only the input file and the binary 
generated will be listed. SALL can be nullified by 
either XALL or LALL. Using SALL generally produces the 
tidiest listing file. 

Use the /M switch described in Table 7-1. 



LALL, LIST, XALL, XLIST 
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PSEUDO-OPS 



SEARCH 



FORMAT 
FUNCTION 



SEARCH tablename (filename) , . . . ,tablename (filename) 

Defines a list of symbol tables for MACRO to search if 
a symbol is not found in the current symbol table. A 
maximum of ten tables can be specified. Tables are 
searched in the order specified. 



When the SEARCH pseudo-op is seen, MACRO checks its 
internal UNIVERSAL table for a memory-resident 
UNIVERSAL of the specified name. (See the UNIVERSAL 
pseudo-op for further discussion of memory-resident 
UNIVERSAL tables and use of the /U switch.) 

If no such entry is found in the UNIVERSAL table, MACRO 
reads in the symbol table using the given file 
specification. If no file specification is given, 
MACRO reads tablename. UNV from the connected directory. 
If no such file is found, MACRO then tries 
UNV: tablename. UNV and SYS: tablename. UNV, in that order. 

When all the specified files are found, MACRO builds a 
table for the search sequence. If MACRO cannot find a 
given symbol in the current symbol table, the UNIVERSAL 
tables are searched in the order specified. When the 
symbol is found, it is moved into the current symbol 
table. This procedure saves time (at the expense of 
core) on future references to the same symbol. 

A UNIVERSAL file can search other UNIVERSAL files, 
provided all names in the search list have been 
assembled. 

The internal table of UNIVERSAL names is cleared on 
each run (gMACRO) or START command, but is not cleared 
when MACRO responds with an asterisk. 

In a PSECTed program, all UNIVERSAL symbols belong to 
the blank PSECT. 

EXAMPLES SEARCH MONSYM»MACSYM 

OPTIONAL Omit the filename and its enclosing parentheses. MACRO 
NOTATIONS then looks on DSK:, UNV:, and SYS: (in that order) for 
tablename . UNV. 



RELATED 
PSEUDO-OPS 



UNIVERSAL 



COMMON 
ERRORS 



Not purging a macro that redefines itself (P error). 
If a macro is found in a universal file, the definition 
is copied into the current macro table and the 
auxiliary table is not searched on Pass 2. Thus, a 
macro that redefines itself can cause P errors similar 
to enclosing the macro by IFl. Such macros should be 
purged before Pass 2. 
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PSEUDO-OPS 



SIXBIT 



FORMAT 



FUNCTION 



EXAMPLES 



SIXBIT dtextd 

d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

Enters strings of text characters in 6-bit format. Six 
characters per word are left justified in sequential 
storage words. Any unused bits are set to zero. 

Lowercase letters in SIXBIT text strings, are treated as 
uppercase. Otherwise, only the SIXBIT character set is 
allowed. (See Appendix A for SIXBIT characters and 
their octal codes.) 



64 45 70 64 00 63 
64 62 51 56 47 00 



SIXBIT \TEXT STRINGX 



644570 640000 



EXP SIXBIT /TEXT/ 



OPTIONAL Omit the space or tab after SIXBIT. This is not 
NOTATIONS allowed if the delimiter is a letter, number, dot, 
dollar sign, or percent sign (that is, a possible 
symbol constituent) , or if the ASCII value of the 
delimiter character is less than 040 or greater than 
172. 

Right-justified SIXBIT can be entered by using single 
quotes to surround up to six characters; for example. 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



006251 475064 'RIGHT' 
ASCII, ASCIZ, .DIRECTIVE FLBLST 

Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 

Using more than six characters in a right-justified 
SIXBIT string, or more than three characters if in the 
address field (Q error) . 

Using non-SIXBIT characters in the text string. 
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PSEODO-OPS 



SQUOZE 



FORMAT 

FUNCTION 

EXAMPLES 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
Errors 



SQUOZE code, symbol 

SQUOZE is a mnemonic for RADIX50. 

126633 472376 RADIX50 lOrSYMBOL 
126633 472376 SQUOZE 10 r SYMBOL 

RADIX50 code, symbol 

SQUOZE , symbol . (code is taken as 0). 

RADIX50 

Code not absolute (A error). 

Code does not end with or 4 (Q error) 
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STOPI 



FORMAT 
FUNCTION 



EXAMPLES 



STOPI 

Ends an IRP or IRPC before all subarguments or 
characters are used. The current expansion is 
completed, but no new expansions are started. STOPI 
can be used with conditionals inside IRP or IRPC to end 
the repeat if the given condition is met. 

LALL 

DEFINE ONETUO<A)< 

I RP A T < I F I DN<A><ONE> f <STOP I 

EXP 1» 
IRP A » <IFIDN<A><TUO> f <STOPI 
EXP 2» 

ONETWO <ArByD>'" 

IRP 
I F I DN<A><ONE> f <STOP I 



IFIDN<B><ONE> r <STOPI 
IFIDN<D><ONE> y <STOPI 

IRP 
IFIDN<A><TUO> r <STOPI 

IFIDN<B><TUO> r <STOPI 

IFIDN<D><TUO> T <STOPI 



EXP !> 
EXP l.:- 
EXP 1> 

EXP 2> 
EXP 2> 
EXP 2> 



000000 000001 



ONETWO <A»ONErBrONErTWO> 

IRP 
I F I DN< A><ONE> r <STOP I 

IFIDN<ONE><ONE> , <STOPI 



IRP 
IFIDN<A><TWO> r <STOPI 

IFIDN<ONE><TWO> r <STOPI 

I F I DN<B><TUO> r <STOP I 

IFIDN<ONE><TWO> r <STOPI 

I F I DN<TWO><T W0> f <STOP I 



000000 000002 



EXP 1> 
EXP 1> 

EXP 2> 
EXP 2> 
EXP 2> 
EXP 2> 
EXP 2> 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



IRP, IRPC 



STOPI not inside IRP or IRPC 
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PSEUDO-OPS 



SUBTTL 



FORMAT 
FUNCTION 



SUBTTL subtitle 

Defines a subtitle (of up to 80 characters) to be 
printed at the top of each page of the listing file 
until the end-of-listing or until another SUBTTL 
statement is found. 

The initial SUBTTL usually appears on the second line 
of the first page of the input file, immediately 
following the TITLE statement. 

For subsequent SUBTTL statements, the following rule 

applies: if the new SUBTTL is on the first line of a 

new page, then the new subtitle appears on that page; 

if not, the new subtitle appears on the next page. 



The statements 



♦ ♦ ♦ 
PRGEND 
TITLE FOO 
SUBTTL BAR 



NOTE 



do not cause BAR to appear as the subtitle on 
the first page of the listing of FOO. 



EXAMPLES 

RELATED 
PSEUDO-OPS 



SUBTTL affects only the listing file, and subtitles can 
be changed as often as desired. 

SUBTTL THIS SECTION CONTAINS DEVICE-DEPENDENT ROUTINES 

TITLE 



3-68 



PSEUDO-OPS 



SUPPRESS 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



SUPPRESS symbol, ... ,symbol 

Turns on a suppress bit in the symbol table for the 
specified symbols. The suppress bit will be turned off 
for any symbol later referenced in the program. 
Symbols whose suppress bits are on at the end of 
assembly are not listed in the symbol table, but will 
be listed in any tables built by CREF unless they are 
XCREFed. 

When an appended parameter file (as opposed to a 
UNIVERSAL file) is used in an assembly, many symbols 
may be defined but never used. These take up space in 
the binary file and complicate listing of the file. 

Unused and unwanted symbols can be removed from tables 
by SUPPRESS or ASUPPRESS. These pseudo-ops control the 
suppress bit in each entry of the symbol table; if the 
bit is on, the symbol in that location is not output. 

ASUPPRESS 



Attempting to suppress an undefined symbol. 
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PSEUDO-OPS 



SYN 



FORMAT 



FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



SYN symlrsym2 

syml = a defined symbol, 

sym2 = a symbol to be defined as synonymous with syml. 

Defines sym2 as synonymous with syml. 

If syml is defined as both a label and an operator, 
sym2 assumes the label definition. 

The following are legal SYN statements: 

SYN X»K 
SYN FAD » ADD 
SYN ENDrXEND 

To turn XLIST into a null operator, 

DEFINE ♦XL < > 
SYN ♦XLfXLIST 

To restore its operation, 

PURGE XLIST 

DEFINE, OPDEF 

Missing symbol (A error) . 

Unknown symbol - first operand not defined (A error). 

Missing comma (A error) . 

Using a variable as one of the symbol arguments (A 
error) . 
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PSEUDO-OPS 



TAPE 



FORMAT 
FUNCTION 

EXAMPLES 



TAPE 

Causes the assembler to begin assembling the program 
contained in the next source file in the MACRO command 
string . 

(Interactive) 

eMACRO 

*DSK : BINAME r LPT : =TTY : r DSK t MORE 

PARAM=6 

TAPE 

JTHIS COMMENT WILL BE IGNORED 

'"Z 

This sets PARAM to 6 and assembles the remainder of the 
program from the source file DSKrMORE. Since MACRO is 
a two-pass assembler, the TTY: file must be repeated 
for Pass 2. 

CMCREPl END OF PASS 13 

PARAM=6 

TAPE 

Note that all text after the TAPE pseudo-op is ignored. 
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PSEUDO-OPS 



TEXT 



FORMAT 



FUNCTION 



.TEXT dtextd 

d = delimiter; first nonblank character, whose second 
appearance terminates the text. 

Generates an ASCIZ REL Block Type for LINK and inserts 
the text string directly into the .REL file output as a 
separate block. (See the LINK Reference Manual .) 

The text inserted in the .REL file is interpreted as a 
command string for LINK. Therefore a MACRO program 
loaded by user commands to LINK can contain additional 
LINK commands, carried out when the MACRO program is 
loaded. 



EXAMPLES 



♦TEXT vset:»high»:5ooooo' 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 



Omit the space or tab after .TEXT. This is not allowed 
if the delimiter is a letter, number, dot, dollar sign, 
or percent sign (that is, a possible symbol 
constituent) , or if the ASCII value of the delimiter 
character is less than 040 or greater than 172. 

.REQUEST, .REQUIRE 



COMMON 
ERRORS 



Using the delimiter character in the text string. 

Missing the end delimiter (that is, attempting to use a 
carriage return as a delimiter) . 
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PSEODO-OPS 



TITLE 



FORMAT 
FUNCTION 



EXAMPLES 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



TITLE title 

Gives the program name and a title to be printed at the 
top of each page of the program listing. 

The first characters (up to six characters, or up to 
the first non-RADIX50 character) are the program name. 
This name is used when debugging with DDT to gain 
access to the program's symbol table. 

The entire text of the title is printed on each page of 
the program listing. 

Only one TITLE statement is allowed in a module; 
programs with PRGEND statements can use one TITLE 
statement for each module. 

A TITLE statement can appear anywhere in the program; 
it usually appears as the first line of the program. 

If no TITLE statement is used, the assembler inserts 
the program name ".MAIN". 

TITLE FLOATING-POINT NUMBER PACKAGE 

The program name is FLOATI; the words FLOATING-POINT 
NUMBER PACKAGE will appear at the head of each page and 
subpage of the listing. 

SUBTTL, UNIVERSAL 



Using more than one TITLE in a program. 

Using TITLE and UNIVERSAL in the same module (M error). 
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PSEUDO-OPS 



TWOS EG 



FORMAT 



FUNCTION 



TWOSEG expression 

expression = any expression giving a nonnegative value 
as the beginning of the program high segment; 
cannot be EXTERNAL. 

Directs MACRO to assemble a two-segment program with 
the high segment beginning at the given address. MACRO 
sets the location counter to the given address, and 
generates a REL Block Type 3, which tells LINK to 
expect two segments. (The address is reduced to the 
next lower multiple of 2000 (octal). If this result is 
0, the address defaults to 400000.) 

Only one TWOSEG pseudo-op is allowed in a program. 

High-segment code is controlled by using RELOC with a 
value at least as large as the TWOSEG address. 
Low-segment code is controlled by smaller RELOC values. 



NOTE 

Using TWOSEG without an argument sets the 
beginning address for the high segment to 
400000. However, this does not set the 
location counter to 400000. 



EXAMPLES 



data: 



start: 



TWOSEG 
RELOC 
BLOCK 10000 
RELOC 400000 
EXIT 



yLow seslment 
fHisih seament 



RELATED 
PSEUDO-OPS 



LOC, .ORG, RELOC 



COMMON 
ERRORS 



Using an EXTERNAL symbol or complex EXTERNAL expression 
as the address argument. 

Using TWOSEG more than once in a program (Q error). 

Generating relocatable code before the TWOSEG pseudo-op 
(Q error) . 

Using PSECT and TWOSEG in the same program. 
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PSEUDO-OPS 



UNIVERSAL 



FORMAT 
FUNCTION 



UNIVERSAL tablename 

Declares the symbol table of the current program 
available to other programs, and stores the given 
tablename in MACRO'S internal UNIVERSAL table. The 
tablename is also taken as the program name, and 
appears in the heading of each page of the listing 
file. 

When an END or PRGEND statement is found, the symbol 
table is placed immediately after the assembler's 
pushdown stacks and buffers. In addition to this 
memory-resident copy of the UNIVERSAL symbol table, the 
file tablename. UNV is generated. (This file can be 
suppressed by the /U switch described in Table 7-1.) 

UNIVERSAL files can be used to generate data, but are 
more commonly used to generate symbols, macros, and 
OPDEFs. The symbols and OPDEFs generated in a 
UNIVERSAL program need not be declared INTERNAL, since 
its local symbols are available to accessing programs. 
(See the SEARCH pseudo-op.) 

Memory-resident UNIVERSAL symbol tables are cleared on 
each run (@MACRO) or START, but are not cleared when 
MACRO responds with an asterisk. This saves redundant 
lookups when many programs search a common set of 
UNIVERSALE. 

Note that if a sequence of programs (or even one 
program) searches more than ten UNIVERSAL symbol 
tables, a SEARCH table overflow occurs. This overflow 
forces reinitialization of the assembler by a run 
(©MACRO) or START command. 

For a UNIVERSAL program that does not generate data 
(that is, it has only symbol, macro, and OPDEF 
definitions) , you can save time by using 1-pass 
assembly. However, such a file must not contain 
forward references to symbol definitions. 

A UNIVERSAL file cannot contain PSECTs. 

(Continued on next page) 
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PSEDDO-OPS 



UNIVERSAL (Cont.) 



NOTES 



For COMPILE-class commands, the existence 
of the file tablename.REL may prevent 
recompilation of the UNIVERSAL file 
tablename.MAC. To avoid this, force 
compilation of the .MAC file by including 
/COMPIL in the command string. 

Generally, a UNIVERSAL file need not be 
reassembled when referencing programs are 
assembled with newer versions of MACRO. 
However, if the UNIVERSALIS assembler 
version is newer than the program's, you 
may get the MCRUVS message, indicating 
skewed UNIVERSAL versions. In this case, 
reassembly or one or both files is required 
(using the same assembler version) . 



EXAMPLES 



UNIVERSAL SI 

START=765 

AC1 = 1 

F=0 

END 



RELATED 
PSEUDO-OPS 



SEARCH, TITLE 



COMMON 
ERRORS 



Using TITLE and UNIVERSAL in the same module (M error) 
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VAR 



FORMAT 
FUNCTION 



EXAMPLES 



VAR 

Causes variable symbols (defined in previous statements 
by suffixing . the number sign (#) , or by ARRAY or 
INTEGER statements) to be assembled as BLOCK 
statements. This has no effect on subsequent 
definitions of symbols of the same type. 

If the VAR statement does not appear in the program, 
all variables are stored at the end of the program. 

If the pseudo-op TWOSEG is used, the variables reserved 
by an array statement must be assigned to the low 
segment;: thus a RELOC back to the low segment is 
required before using the VAR pseudo-op. 



RELATED 
PSEUDO-OPS 



402003' 
402004' 
402005' 
402006 ' 
402007' 
402010' 
402011' 
001052' 
001052' 
001055' 



ARRAY, BLOCK, INTEGER 



201 01 01 000000 

202 01 00 402012' 

201 02 02 000000 

202 02 00 402013' 
140 01 00 000002 
200 01 00 402014' 
263 17 00 000000 



ADD2: MOVEI IrO(l) 

MOVEM If FIRST* 
MOVEI 2»0<2) 
MOVEM 2 » SECOND* 
ADD lr2 
MOVE IrSUM* 
POP J 17 f 
RELOC 

VAR 
BLOCK 2 
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PSEUDO-OPS 



XALL 



FORMAT 
FUNCTION 



XALL 

Resumes standard listing after previous LALL or BALL. 
(XALL is the default among these three.) 

XALL suppresses all lines of the program listing file 
that do not generate binary code. 

XALL does not suppress REPEAT expansions. 



NOTE 

Under XALL only one listing line is output for 
each source line generating binary code in a 
macro expansion. Occasionally, a single line 
of a macro definition expands into several 
lines of listing text. When this occurs, part 
of a binary-generating source line may not be 
listed. 

You can avoid this by temporarily setting the 
listing mode to LALL (list all) or SALL 
(suppress all) around such lines. 



RELATED 
PSEUDO-OPS 

OPTIONAL 
NOTATIONS 



LALL, LIST, SALL, XLIST 



Use the /X switch described in Table 7-1 
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PSEUDO-OPS 



.XCREF 



FORMAT 
FUNCTION 



OPTIONAL 
NOTATIONS 



RELATED 
PSEUDO-OPS 

COMMON 
ERRORS 



.XCREF symbol ,... ^symbol 

Suspends output of cross-referencing for the specified 
symbols. References to these symbols between this 
statement and the next .CREF or the end of the program 
will not appear in the cross-reference listing. 

.XCREF 

If no symbol names are specified, MACRO suspends 
cross-referencing for all symbols. 

.CREF 



Specifying a nonexistent symbol (A error). 
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PSEUDO-OPS 



XLIST 



FORMAT 
FUNCTION 

EXAMPLES 



RELATED 
PSEUDO-OPS 

OPTIONAL 
NOTATIONS 



XLIST 

Suspends output to the program listing file. This 
output occurs only in Pass 2; XLIST does not affect 
Pass 1. To resume output, use the pseudo-op LIST. 

-The following sequence of code shows an XLIST pseudo-op 
suppressing listing of literals: 



JEnd of pro^rsm 
rDon't list literals 



EXIT 

XLIST 

LIT 

LIST 

END 



This sequence of code lists as: 

401023' 104 00 00 000170 HALTF ?End of program 

XLIST fDon't list literals 

LIST 

END 

Note that the high-segment break will be greater than 
401023' because the literals are assembled after the 
HALTF. 

LALL, LIST, SALL, XALL 



Use the /S switch described in Table 7-1. 
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XPUNGE 



FORMAT 
FUNCTION 



RELATED 
PSEUDO-OPS 



XPUNGE 

Deletes all local symbols during Pass 2. This reduces 
the size of the .REL file and speeds up loading. 
XPUNGE should immediately precede the END statement. 

PURGE 
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PSEUDO-OPS 



XWD 



FORMAT 
FUNCTION 



EXAMPLES 



OPTIONAL 
NOTATIONS 



COMMON 
ERRORS 



XWD lefthalf ,righthalf 

Enters two halfwords in a single storage word. Each 
half is formed in a 36-bit register, and the low-order 
18 bits are placed in the. halfword. The high-order 
bits are ignored. 

XWD statements are used to set up pointer words for 
block transfer instructions. Block transfer pointer 
words contain two 18-bit addresses; the left half is 
the starting location of the block to be moved, and the 
right half is the first location of the destination. 



402017' 200 02 00 403040' 
402020' 251 02 00 403035' 



****** 
402636 
402736 



FRDMi: 
TOIJ 



MOVE 2rCXWD FR0MlrT013 
BUT 2rT0ENDl 

BLOCK 100 
BLOCK 100 
T0END1=,-1 



403035' 

lef thalf , ,righthalf 

BYTE (18)lefthalf ,righthalf 

Using halfword with absolute value larger than 18 bits 
(Q error) . 

Using two commas between the arguments to XWD. For 
example, XWD A, 3 is correct; XWD A,, 3 is incorrect. 
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FORMAT 
FUNCTION 

EXAMPLES 



Z accumulator, address 

Z is treated as if it were the null machine language 
mnemonic. An instruction word is formed with zeros in 
bits to 8 . The rest of the word is formed from the 
accumulator and address. (See Section 4.7.1.) 



403036' 000 00 00 OOOOOO 
403037' 000 01 04 000002 



Z 1>2(4) 
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CHAPTER 4 
MACRO STATEMENTS AND STATEMENT PROCESSING 



A MACRO statement has one or more of the following: a label, an 
operator, one or more operands, and a comment. The general form of a 
MACRO statement is: 



label: operator operand, operand 
A carriage return ends the statement. 



;comment 



NOTES 



Direct-assignment statements receive 
special handling. (See Section 
2.4.2.2.) 

Processing of macros is not 
discussed here because a macro call 
produces a text substitution. After 
substitution, the text is processed 
as described in this chapter. 
Macros are discussed in Chapter 5. 



4 . 1 LABELS 

A label is always a symbol with a suffixed colon. (See Section 
2.4.2.1.) The assembler recognizes a label by finding the colon. If a 
statement has labels (you can use more than one) , they must be the 
first elements in the statement. 



A label can be defined only once; its value is 
first word of code generated after it. 



the address of the 



Since a label gives an address, the label can be either absolute or 
relocatable. A label is a local symbol by default. You can declare a 
label INTERNAL global or EXTERNAL global. (See Section 2.4.5.) 
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4 . 2 OPERATORS 

After processing any labels, the assembler views the following 
nonblank, nontab characters as a possible operator. An operator is 
one of the following; 

1. A MACRO-def ined mnemonic. All mnemonics are listed in 
Appendix C, and are discussed in the Hardware Reference 
Manual . 

2. A user-defined operator. (See the pseudo-op OPDEF in Chapter 
3.) 

3. A pseudo-op. (See Chapter 3.) 

If the characters found do not form one of the above, then MACRO views 
them as an expression. 

An operator is ended by the first non-RADIX50 character: if it is 
ended by a blank or tab, operands may follow; if it is ended by a 
semicolon, there are no operands and the comment field begins; if it 
is ended by a carriage return, the statement ends and there are no 
operands or comments. 



4.3 OPERANDS 

After processing labels and the operator, if any, the assembler views 
as operands all characters up to the first unquoted semicolon or 
carriage return. Commas delimit the operands. 

The operator in a statement determines the number (none, one, two or 
more) and kinds of permitted or required operands. Any expected 
operand not found is interpreted as null. An operand can be any 
expression or symbol appropriate for the operator. 



4 . 4 COMMENTS 

The first unquoted semicolon in a statement begins the comment field. 
You can use any ASCII characters in a comment; however, angle 
brackets in a comment may produce unpredictable results. You can 
continue a comment to the next line by typing CTRL/ , followed by a 
carriage return. 

If the first nonblank, nontab character in a line is a semicolon, the 
entire line is a comment. You can also enter a full line of comment 
with the pseudo-op REMARK, or a multiline comment with the pseudo-op 
COMMENT. (See Chapter 3.) 

Comments do not affect binary program output. 
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4.5 STATEMENT PROCESSING 

MACRO processes your program as a linear stream of data. During Pass 
1, MACRO may find references to symbols not yet defined. These 
symbols are entered in the user symbol table. Whenever a symbol is 
defined, it is entered in the table with its value, so that on Pass 2 
all definitions can be found in the table. The values then replace 
the symbols in the binary code generated. 

NOTE 

Delayed definition is allowed only for 
labels and direct-assignment symbols. A 
symbol that contributes to code 
generation (for example, an OPDEF, a 
macro, or a REPEAT index) must be 
defined before any reference to it. 

Statement processing proceeds as follows: 

1. Labels are found and entered in the user symbol table. 

2. The next characters up to the first unquoted semicolon, 
blank, tab, comma, or equal sign are processed. 

a. Equal sign: the characters form a symbol, and the 
following characters form an expression. The symbol and 
the value of the expression are entered in the user 
symbol table. 

b. Other delimiter: the characters form an expression or an 
operator. If an operator, it is found in a table and 
assembled. If an expression, its value is assembled. 

3. If the operator takes operands, the next characters up to the 
first unquoted semicolon or carriage return form operands. 
Unquoted commas delimit operands. For each operand, leading 
and trailing blanks and tabs are ignored. Operands are 
evaluated and assembled for the given operator. 

4. The first unquoted semicolon ends processing of the line. 
Any further characters up to the first carriage return are 
comment. 

5. The first unquoted carriage return ends the statement. Any 
following characters begin a new statement. 



4.6 ASSIGNING ADDRESSES 

MACRO normally (and by default) assembles statements with relocatable 
addresses. Assembly begins with the zero storage word and proceeds 
sequentially. Each time MACRO assembles a word of binary code, it 
increments its location counter by 1. 
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A mnemonic operator generates one word of binary code. Direct- 
assignment statements and some pseudo-ops do not generate code. Some 
pseudo-ops generate more than one word of code. 

You can control address assignment by setting the assembler's location 
counter using the pseudo-ops LOC and RELOC. (See Section 9.1.) 

You can also reference addresses relative to the location counter by 
using the dot symbol (.). For example, the expression .-1 used as an 
address refers to the location immediately preceding the current 
location. 

In revising MACRO programs, you can cause an incorrect address to be 
assembled by adding or removing statements within the range of a .+n 
expression. For example, in the sequence 

000000' 332 00 01 000000 SKIPE 0(AC) 
000001' 254 00 00 001020' JRST GOTONE 
000002' 344 01 00 000000' AOJA AC»,-2 

the expression .-2 gives the address of the SKIPE statement. If you 
revise this sequence by inserting a statement, you should change the 
expression to .-3 so that it still refers to the correct statement. 

000000' 332 00 01 000000 SKIPE 0(AC) 

000001' 254 00 00 001020' JRST GOTONE 

000002' 350 00 00 000014 AOS NULCNT ?Added line 

000003' 344 01 00 000000' AOJA AC»»-3 JChaniSed line 

For this reason, use great care with such expressions other than .+1 
and .-1. Using labels avoids this problem entirely. 



4.7 MACHINE INSTRUCTION MNEMONICS AND FORMATS 

There are two kinds of machine instruction mnemonics: primary and 
input/output. Primary instructions generate binary code in primary 
instruction format; input/output instructions generate binary code in 
input/output instruction format. 



4.7.1 Primary Instructions 

A primary instruction is in one of the forms 

mnemonic accumulator , address 
mnemonic accumulator, 
mnemonic address 

where mnemonic is a machine instruction mnemonic, accumulator is an 

accumulator register address, and address is a memory address. The 

memory address can be modified by indexing, indirect addressing, or 
both. 
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A complete list of machine instruction mnemonics and their octal codes 
is given in Appendix C, and these mnemonics are discussed in the 
Hardware Reference Manual . 

The accumulator address gives the address of a register, and can be 
any expression or symbol whose value is an integer in the range to 
17 octal. 

The memory address gives a location in memory, and can be any 
expression or symbol whose value is an integer in the range to octal 
777777. 

You can modify the memory address by indirect addressing, indexed 
addressing, or both. For indirect addressing, prefix an at sign (@) 
to the memory address in your program. For indexed addressing, suffix 
an index register address in parentheses to the memory address in your 
program. This address can be any expression or symbol whose value is 
an integer in the range 1 to octal 17. 



NOTE 

To assemble the index, MACRO places the 
index register address in a fullword of 
storage, swaps its halfwords, and then 
adds the swapped word to the instruction 
word . 



For an example of a primary instruction (assuming that AC17, TEMP, and 
XR have the octal values 17, 100, and 3, respectively) , the statement 

ADD AC17»eTEMP(XR) 
generates the binary code 



instruction 
code 



indirect 
bit 



010 111 000 1 111 1 
accumulator 



Oil 



memory 
address 

000 000 000 001 000 000 



index 
register 



which appears in the program listing as 

270 17 1 03 000100 ADD AC17r0TEMP<XR) 

The mnemonic ADD has the octal code 270, and this is assembled into 
bits to 8. The accumulator goes into bits 9 to 12. Since the @ 
appears with the memory address, bit 13 is set to 1. The index 
register goes into bits 14 to 17. Finally, the memory address is 
assembled into bits 18 to 35. 

If any element is missing from a primary instruction, zeros are 
assembled in its instruction word field. 
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4.7.2 Mnemonics With Implicit Accumulators 

A few mnemonics set bits in the accumulator field as well as in the 
instruction field. Therefore these mnemonics do not take accumulator 
operands, and are of the form 

mnemonic address 

These mnemonics and their octal codes are listed in Table C-5 in 
Appendix C. 

For example, the mnemonic JFOV gives the octal code 25504; JFCL gives 
255. Therefore both give the opcode 255 in bits to 8, but JFOV also 
sets the accumulator bits (9 to 12) to binary 0001. This makes JFOV 
100 equivalent to JFCL 1,100: 

255 01 00 000100 JFOV 100 
255 01 00 000100 JFCL IrlOO 



4.7.3 Input/Output Instructions 

An input/output statement in your program resembles a primary 
instruction statement except that the first operand gives a device 
number instead of an accumulator. The general format is: 

mnemonic device, address 

In an input/output instruction, the indirect, index, and address 
fields (bits 13 to 35 inclusive) are assembled exactly as in a primary 
instruction. 

Unlike a primary instruction word, however, an input/output word has a 
split instruction code in bits to 2 (always set to 111 binary) and 
10 to 12, and a device code in bits 3 to 9. The device code can be 
any expression or symbol giving a valid device code for your system. 

(MACRO-def ined I/O instruction mnemonics and device code mnemonics are 
listed in Tables C-2 and C-3 in Appendix C.) 

For example (assuming that NVR has the octal value 1037) , the 
statement 

DATAI CDRreN'v;R(4) 
generates the binary code 

memory 
address 

111 001 001 1 00 1 1 100 000 000 001 000 Oil 111 

index 
register 



device 


indirect 


code 


bit 


001 001 1 


00 1 1 


instruction 




code 


re 



which appears in the listing as 

7 114 04 1 04 001037' DATAI CriR»eNVR(4) 
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The octal code for the mnemonic DATAI is 70004, which is written in 
bits to 14. The octal device code 114 (for card reader) is then 
overwritten in bits 3 to 9. The @ in the statement sets bit 13 to 1. 
The index register and memory address are placed in bits 14 to 17 and 
18 to 35/ as in a primary instruction. 



4.7.4 Extended Instructions 

The KLIO Extended Instruction Set is a multifunction instruction set 
that performs character-string editing, decimal-to-binary conversion, 
string move with left or right justification, string move with offset 
or translation, and string compare. 

The Extended Instruction Set consists of a single KLIO instruction 
(EXTEND, octal 123) and a set of 16 extended operators. (See the 
Supplement to the Hardware Reference Manual .) 

The KLIO EXTEND instruction mnemonics are listed in Table C-4 in 
Appendix C. 
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CHAPTER 5 
USING MACROS 



A macro is a sequence of statements defined and named in your program. 
When you call a macro (by invoking its name in your program) , the 
sequence of statements from its definition is generated in line, 
replacing the call. A macro can have arguments. 

By using macros with arguments, you can generate passages of code that 
are similar, but whose differences are controlled by the passed 
arguments. This saves repetition in building a source file. 



5.1 DEFINING MACROS 

Before you can call a macro, you must define it. You can also 
redefine a macro if you wish; the new definition simply replaces the 
old one. 

To define (or redefine) a macro, use the pseudo-op DEFINE: 

DEFINE macroname (darglist) <macrobody> 

where macroname is the name of the macro, darglist is an optional list 
of dummy-arguments, and macrobody is a sequence of statements. 

The macroname is a symbol; you must follow the rules for valid 
symbols in selecting a macroname. (See Section 2.4.1.) 

The optional dummy-argument list can give one or more dummy-argument 
symbols through which values are passed to the sequence of statements. 
If a macro definition has dummy-arguments, they must be enclosed in 
parentheses. Use commas as delimiters between dummy-arguments. For 
each dummy-argument, leading and trailing spaces and tabs are ignored. 

The macrobody is the sequence of statements you want to generate when 
you call the macro. The macrobody must be enclosed in angle brackets. 

Here is an example of a macro definition: 
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DEFINE VMAG < WHERE »LENG) < 

JVector length routine 



MOVE 0» WHERE 

FMP 

MOVE 1»WHERE+1 

FMP Irl 
FAD 1 

M0VEl»WHERE+2 

FMP 1»1 
FAD 1 

PUSHJ 17»FSQRT 
MOVEM LENG 



Get first 

component 
Sauare it 
Get second 

coi,ijPonent 
Sauare it 
Add souare 

of second 
Get third 

component 
Sauere it 
Add square 

of third 
Floating SORT 

routine 
Store the 

lenath 



NOTE 

Comments in a macro use storage. If you 
begin a comment with a double semicolon, 
the comment is listed in the definition 
but not stored for listing with 
expansions. 



5.2 CALLING MACROS 

You can call a macro by putting its name in your program. Recall that 
you must define the macro before you can call it. You can use the 
macroname as a label, an operator, or an operand. 

If the macro's definition has dummy-arguments, the macro call can have 
arguments. The arguments passed to the macro are inserted into the 
defined sequence of statements as it is generated. The first passed 
argument replaces the first dummy-argument; the second passed 
argument replaces the second dummy-argument; this treatment continues 
for each argument passed. Any missing arguments are passed as nulls 
(zeros) or filled in by default arguments (see Section 5.5). 



NOTE 



If FOO is a macro w 
arguments, the call 
and C as the first and 
The second argument is 
it is not considered mi 
be replaced by a defau 
fourth argument is miss 
replaced by a defaul 
has been defined; o 
passed as nulls. (See 



ith four dummy- 
FOO A, ,C passes A 
third arguments, 
passed as nulls; 
ssing and cannot 
It argument. The 
ing and will be 
t argument if one 
therwise it is 
Section 5.5.1.) 
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After argument substitution, the defined sequence of statements 
replaces the macroname and argument list in the source text. For 
example, suppose you have defined VMAG(A,B) as shown in Section 5.1 
above, and VMAG appears in your program as 





LALL 








P7=245 








VLEN=11 








PLACE=15 






TAGIJ 


MOVE lfP7 


JGet 


P7 




MOVEM PLACE 


;put 


it in PLACE 


TAG2: 


VMAG PLACE »VLEN 






tags: 


MOVE 1»VLEN 


JGet 


length 



Then the code to be assembled is: 



000245 
000011 
000015 
200 01 00 000245 
202 00 00 000015 



200 


00 





00 


000015 


160 


00 





00 


000000 


200 


01 





00 


000016 


160 


01 





00 


000001 


140 


00 





00 


000001 


200 


01 





00 


000017 


160 


01 





00 


000001 


140 


00 





00 


000001 


264 


00 





00 


001007' 


202 


00 





00 


000011 





LALL 






P7=245 






VLEN=11 






PLACE=15 




TAGi: 


MOVE lrP7 , 


'Get P7 




MOVEM PLACE j 


Put it in PLACE 


TAG2: 


VMAG PLACE yVLEN-" 






J Vector lendth routine 




MOVE OrPLACE J 


Get first 
' component 




FMP i 


Sauare it 




MOVE lrPLACE+1 1 


'Get second 
' component 




FMP 1»1 . 


'Sauare it 




FAD 1 i 


Add sauare 
1 of second 




MOVE l»PLACE+2 i 


'Get third 
' component 




FMP 1»1 1 


'Sauare it 




FAD 1 ; 


'Add sauare 
' of third 




JSR FSQRT 


'Floating SORT 
' routine 




MOVEM VLEN 1 


>Store 
> length 



200 01 00 000011 



tags: 



MOVE IfVLEN 



J Get length 



Notice that the macro definition has the dummy-arguments A and B in 
the macrobody. The call VMAG PLACE, VLEN causes PLACE to replace each 
appearance of A, and VLEN to replace each appearance of B. 



NOTES 



Under LALL, when the text of a 
macrobody is listed at call, it is 
enclosed in up-arrows (") . 

Under XALL, the beginning of the 
text of a macrobody is marked by an 
up-arrow; the ending is marked by 
an up-arrow only if the last line of 
the macrobody generates binary code. 
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5.2.1 Macro Call Format 

In a macro call, delimit the macroname with one or more blanks or 
tabs. 

If the macro has arguments, the first nonblank, nontab character 
begins the argument list. Each argument ends with a comma, a carriage 
return, or a semicolon. These three characters cannot be used within 
arguments unless enclosed by special quoting characters. (See Section 
5.2.2.) 

Leading and trailing spaces and tabs are stripped from each argument 
unless they are within special quoting characters. Embedded spaces 
and tabs are not stripped. 

You can continue an argument to the next line by using 
CTRL/underscore. Otherwise an unquoted carriage return or semicolon 
ends the argument and the argument list. An unquoted semicolon also 
begins the comment field. 



5.2.2 Quoting Characters in Arguments 

The special quoting characters for macro argument handling are: 

< > angle brackets 

( ) parentheses 

[ ] square brackets 

" " quote marks 

NOTE 

Single quote marks (apostrophes) are not 
special quoting characters. 

Any character, including the semicolon (;), enclosed in special 
quoting characters is treated as a regular character. If one of the 
special quoting characters is to be passed as a regular character, it 
must be enclosed by different special quoting characters. 

Here are the rules for macro argument handling. In the examples, FOO 
is assumed to be a defined macro: 

1. The special quoting characters are not argument delimiters. 
They only tell the assembler to treat the enclosed characters 
as regular characters. 

FOO C<A,B> has one argument: C<A,B>. 

FOO C,D<A,B> has two arguments: C and D<A,B>. 
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2. With the two exceptions explained below, special quoting 
characters are always included in passed arguments. 

FOO A, (B,C) has two arguments: A and (B,C) . 

FOO [XWD 1,L1]-1(AC) has one argument: [XWD 1,L1]-1(AC). 

FOO "(",0 has two arguments: "(" and 0. 

Exception 1: If the first character of the argument list is 
a left parenthesis, then it and its matching right 
parenthesis delimit the argument list. They are not treated 
as special quoting characters and are not included in passed 
arguments. All nested quoting characters except ^ngle 
brackets are disabled. After stripping the outer 
parentheses, angle brackets are handled as described in 
Exception 2 below. 

FOO (A,B,C) has three arguments: A, B, and C. 

FOO (7LENGTH >132) has one argument: 7LENGTH >132. 

FOO ([A,B]) has two arguments: [A and B] . 

FOO (<A,B>) has one argument: A,B. 

Exception 2: If a left angle bracket is the first character 
of the argument list, or the first character after an 
unquoted comma, then it and its matching right angle bracket 
are treated as special quoting characters, but are not 
included in passed arguments. 

FOO <A,B>,C has two arguments: A,B and C. 

FOO C,<A,B> has two arguments: C and A,B. 

You can alter this argument handling by using the pseudo-op .DIRECTIVE 
with MACMPD, .ITABM, and .XTABM. (See Chapter 3.) 

NOTE 

To pass special characters in a macro 
call, we suggest defining the macro so 
that the delimiters are part of the 
passed argument. For example, use 

DEFINE Tl (A) <OUTSTR CASCIZ A3> 

rather than 

DEFINE T2 (A) <OUTSTR CASCIZ \A\3> 

The call Tl ">>" will work, but T2 ">>" 
will not. 
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5.2.3 Listing of Called Macros 

You can control the listing of called macros by using the pseudo-ops 
XALL, SALL, and LALL. LALL causes macro expansions to be listed in 
full; XALL suppresses part of the listing; LALL suppresses all of 
the listing. The default among these three is XALL. 

The following example shows the action of these pseudo-ops on macro 
listings: 

DEFINE FOO (NX 







IFE N> 


<2> 






IFN Hf 


<1> 






SALL 




000000 


000002 


F00<0) 




000000 


000001 


F00<1> 
XALL 








F00<0) 


"^ 


000000 


000002 


IFE Or 


<2> 






F00<1) 


« 


000000 


000001 


IFN 1» 
LALL 


<1> 






FOOCO) 


« 


000000 


000002 


IFE 0. 


<2> 






IFN Oi 


<1> 






FOO(i: 


" 






IFE 1. 


<2> 


000000 


000001 


IFN 1. 


<1> 



5.3 NESTING MACRO DEFINITIONS 

You can nest macro definitions. That is, you can define a macro 
within the body of another macro definition. Notice, however, that 
the nested macro is not defined to the assembler until the nesting 
macro is called. 

Here is an example: 

DEFINE PERSON (A) < 

DEFINE CHILD (B) < 

DEFINE GRANDCHILD <C) < 
EXP AfBrO 
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Until the DEFINE PERSON statement is assembled, calls to PERSON, 
CHILD, and GRANDCHILD are illegal. These macros are not yet defined 
to the assembler. 

When the DEFINE PERSON statement is reached and assembled, PERSON can 
be called, but not CHILD or GRANDCHILD. The call PERSON 1 generates 
the text 



PERSON 1' 



DEFINE CHILD (B) < 

DEFINE GRANDCHILD (C) 
EXP IfB^O 



thus defining CHILD to the assembler, 
generates the text 



The following call CHILD 2 



CHILD 2' 



DEFINE GRANDCHILD (C) 
EXP lr2rC> 



and GRANDCHILD is defined to the assembler. Finally, a call to 
GRANDCHILD 3 generates 



000000 000001 
000000 000002 
000000 000003 



GRANDCHILD 3' 



EXP 1»2»3' 



Notice the result of a subsequent call to CHILD 10. The text 

CHILD 10" 

DEFINE GRANDCHILD (C) < 
EXP l»10rC> 



is generated, and this definition replaces the old definition of 
GRANDCHILD; the definitions of PERSON and CHILD are not changed. 
After this, the call GRANDCHILD 3 generates 



000000 000001 
000000 000010 
000000 000003 



GRANDCHILD 3' 



EXP IrlOrZ' 



NOTE 

Using multiple angle brackets for a 
passed argument preserves the argument 
as one unit. For example passing the 
argument <<A,B,C>> to nested macros 
causes the outer macro to pass <A,B,C> 
as one argument; the first nested macro 
passes A, B, and C as three arguments. 
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5.4 CONCATENATING ARGUMENTS 

The apostrophe (') is the concatenation operator for macro calls. If 
you insert an apostrophe immediately before or after a dummy-argument 
in the body of a macro, the assembler removes it at call. This 
removal joins (concatenates) the passed argument to the neighboring 
character in the generated text. 

(One application of this concatenation is shown under COMMON ERRORS 
for the ASCIZ pseudo-op.) 

If the apostrophe precedes the dummy-argument, the passed argument is 
suffixed to the preceding character; if the apostrophe follows the 
dummy-argument, the passed argument is prefixed to the following 
character . 

You can use more than one apostrophe with a dummy-argument. In this 
case only apostrophes next to the dummy-argument will be removed (at 
most one from each side) . Other apostrophes are treated as regular 
characters in the macrobody. The following example shows the 
treatment of apostrophes on both sides of the dummy-argument, and of 
double apostrophes. 

DEFINE (PREFIXrMIDFIX) < 

DEFINE OCOMP (SUFFIX) < 

PREFIX 'O'MIDFIX" SUFFIX> 



Now the call A, J generates 

DEFINE OCOMP (SUFFIX) < 
AOJ'SUFFIX> 

because when the assembler replaces PREFIX with A, the apostrophe 

following is removed to form AO, When J replaces MIDFIX, the 

preceding apostrophe and first following apostrophe are removed to 
form AOJ'SUFFIX. 

Now the call OCOMP LE generates 

OCOMP LE*" 
343 00 00 000000 AOJLE'" 

since the apostrophe is removed to join AOJ to LE. 



5.5 DEFAULT ARGUMENTS AND CREATED SYMBOLS 

Ordinarily, an argument missing from a macro call is passed as nulls. 
For example, the macro defined by 

DEFINE WORDS (ArB»C) < 
EXP AfBrO 

when called by WORDS 1,1 generates three words containing 1, 1, and 0, 
respectively. 

WORDS Irl'" 
000000 000001 EXP Iflr" 

000000 000001 
000000 000000 
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You can, however, alter this handling by specifying default values 
other than nulls, or by using created symbols. 



5.5.1 Specifying Default Values 

If you want a missing argument to default to some value other than 
nulls, you can specify the default value in your DEFINE statement. Do 
this by inserting the default value in angle brackets immediately 
after the dummy-argument. For example, the macro defined by 

DEFINE WORDS (A»B<222>yC<333>)< 
EXP ArB»C> 



when called by WORDS 1,1 generates three words containing 1, 1, and 
333, respectively. 



000000 000001 
000000 000001 
000000 000333 



WORDS Ifl-- 

EXP 1»1>333' 



NOTE 

An argument passed as nulls by 
consecutive commas is not considered 
missing and cannot invoke a default 
value. Therefore missing arguments can 
occur only at the end of the list of 
passed arguments. 



5.5.2 Created Symbols 

A symbol used as a label in a macrobody must be different for each 
call of the macro (since duplicate labels are not allowed) . Therefore 
for each call a different symbol for the label must be passed as an 
argument. 

If you do not refer to such a label from outside the macro, you can 
simply let the assembler provide a new label for each call. This 
label is called a created symbol, and is of the form ..nnnn where nnnn 
is a 4-digit number. 

To use a created symbol in place of a passed argument, use the percent 
sign (%) as the first character of the dummy-argument in your DEFINE 
statement. The assembler then creates a symbol for use in the macro 
expansion if that argument is missing from a call to the macro. If 
you provide an argument in the call, the passed argument overrides the 
created symbol. 
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1. A null argument (indicated by two 
adjacent delimiters) is not treated 
as missing. 

2. Avoid using symbols of the form 
..nnnn, since they could interfere 
with created symbols. 



The following example shows a macro defined with a created symbol, the 
macro called using the created symbol, and the macro called overriding 
the created symbol: 

DEFINE COMPAR ( TEST f SAVE r INDEX »%HERE) < 
%HEREJ MOVE SAVE r TEST 

SETZ INDEX f 

CAME SAVE STABLE (INDEX) 

JRST ZHERE 
> 

COMPAR rifT2rT3-' 
♦.OOOi: MOVE T2»T1 

SETZ T3» 

CAME T2 r TABLE (T3) 

JRST wOOOl 
COMPAR TlfT2TT4rHEREl'" 
HEREIJ MOVE T2fTl 

SETZ T4 

CAME T2rTABLE(T4> 

JRST HEREl 



5.6 INDEFINITE REPETITION 

The pseudo-ops IRP, IRPC, and STOPI give a convenient way to repeat 
all or part of a macro; you can change arguments on each repetition 
if you wish, and the number of repetitions can be computed at assembly 
time. You can use these three pseudo-ops only within the body of a 
macro definition. 

To see how IRP works, assume the macro definition 

DEFINE DOEACH (A) < 
IRP Ar<Pt» 

The call DOEACH < ALPHA, BETA, GAMMA> produces the code 

000200 ALPHA=200 

000300 BETA=300 

000400 GAMMA=:400 

DOEACH <ALPHA»BETA)- GAMMAS"* 
IRP 
000000 000200 ALPHA 

000000 000300 BETA 

000000 000400 GAMMA 

because each subargument passed to IRP generates one repetition of the 
code. Notice that the range of IRP must be enclosed in angle 
brackets. 
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NOTE 



Using angle brackets in the call to 
DOEACH is critical, since they make the 
string ALPHA, BETA, GAMMA a single 
argument for IRP. IRP then sees the 
commas as delimiting subarguments. 



IRPC is similar to IRP, but an argument passed to IRPC generates one 
repetition for each character of the argument. 

STOPI ends the action of IRP or IRPC after assembly of the current 
expansion. You can use STOPI with a conditional assembly to calculate 
a stopping point during assembly. For example: 

JEnter value of 111 for each radix from 2 to K 

DEFINE CONVl (L) < 

RADIX L JSet radix- 
Ill ; Evaluate and enter 
RADIX 8 fBack to radix 8 



DEFINE CONVERT (A) < 

IRP Ar<IFE K-A,<STOPI> ? Still OK? 
CONVl A> rCONVl 



000004 



000000 000007 



K=4 

CONVERT <2r3»4f5»6f7f8»9>'" 

IRP 
IFE K-2»<ST0PI> J Still OK? 
CONVl 2-^ 

RADIX 2 ;Set radix 

111 JEvaluate and enter 

RADIX 8 ?Back to radix 8 



000000 000015 



IFE K-3»<ST0PI> r Still OK? 
CONVl 3" 
RADIX 3 JSet radix 
111 rEvaluate and enter 
RADIX 8 rBack to radix 8 



000000 000025 



IFE K-4»<ST0PI> r Still OK? 
CONVl 4'" 
RADIX 4 J Set radix 
111 rEvaluate and enter 
RADIX 8 JBack to radix 8 



JCONVl 



5.7 ALTERNATE INTERPRETATIONS OF CHARACTERS PASSED TO MACROS 

The normal argument passed by a macro call is simply the string of 
characters given with the call. MACRO offers three alternate 
interpretations of the passed argument. 
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If you prefix a backslash (\) to an expression argument, the argument 
passed is the ASCII numeric character string giving the value of the 
expression. 

If you prefix a backslash-apostrophe (\ ' ) to an expression argument, 
the argument passed is the string whose value is the SIXBIT string 
with the integer value of the expression. 

If you prefix a backslash-quotemark (\") to an expression argument, 
the argument passed is the string whose value is the ASCII string with 
the integer value of the expression. 

To show how these work, the following example defines a macro to print 
the argument passed. Then four different arguments are passed using 
the various argument interpretations. 

LALL 

DEFINE LOOK IE (ARG) < 

REMARK The passed ar^uinent isJ ARG > 

LOOKIE 60"^ 

REMARK The passed ariaument is* 60 

LOOKIE \60" 

REMARK The passed argument is* 60 

LOOKIE \'60" 

REMARK The passed argument is* P 

LOOKIE \"60'' 

REMARK The passed argument is* 

000060 Z=60 

LOOKIE Z-" 

REMARK The passed ardument is* Z " 

LOOKIE XZ-" 

REMARK The passed ar53uiTient is* 60 

LOOKIE X'Z*^ 

REMARK The passed ar^utfient is* P " 

LOOKIE \"Z'" 

REMARK The passed argument is* 

635170 425164 ZZ='SIXBIT' 

LOOKIE ZZ-^ 

REMARK The passed argument is* ZZ 

LOOKIE \ZZ'" 

REMARK The passed argument is: 635170425164 *" 

LOOKIE \'ZZ" 

REMARK The passed arduinent is: SIXBIT ^ 
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203234 162311 ZZZ="ASCII 



LOOKIE ZZZ'" 

REMARK The passed srsiumerit is* ZZZ " 

LOOKIE XZZZ-^ 

REMARK The passed srdument ist 203234162311 

LOOKIE \"ZZZ" 

REMARK The passed argument is J ASCII *" 
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CHAPTER 6 
ASSEMBLER ODTPUT 

MACRO can generate three kinds of output files: 

1. A program listing (.LST) file 

2. A binary program (.REL) file 

3. A UNIVERSAL (.UNV) file 

6.1 THE PROGRAM LISTING FILE 

MACRO outputs the program listing file to the device you specify, 
usually your terminal or a disk file. You can control the form of the 
program listing by using the pseudo-ops .DIRECTIVE FLBLST, .DIRECTIVE 
SECOND, LIST, XLIST, LALL, XALL and SALL. (See Chapter 3.) All MACRO 
programs begin with the implicit pseudo-ops LIST and XALL. 

The listing has a heading at the top of each page and subpage. The 
first line gives the program name, the assembler version, the time and 
date of assembly, and the page number. The second line gives the 
program filename (including file type), the date and time of creation, 
and an optional program subtitle. 

Example: 

TIMER MACRO %53(711) 10:07 27-APR-77 PAGE 2 
TIMER MAC 27-AUG-77 10106 MACDEP 

The listing has up to 55 lines per page. You can change this by using 
the L switch; /nnL specifies nn lines per page. A formfeed (CTRL/L) 
in your program begins a new page and increments the page number. If 
the linecount exceeds lines-per-page before a formfeed is found, a 
subpage number is formed. For example, the subpages following page 6 
are 6-1, 6-2, and so forth. A formfeed would begin page 7. 
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The five columns in the program listing give: 

1. The CREF line number (if the program was assembled with the 
CREF switch on) . 

2. The line sequence number (if the input file is sequenced). 

3. The 6-digit octal address of the storage word, usually a 
sequential location assignment. 

400066' 
400067' 
400070' 

An apostrophe (') after the address shows that it is 
relocatable. 

For a PHASE pseudo-op, the phased address is given. 

For a BLOCK pseudo-op, only the address of the first word is 
given. 

For a program with PSECTS, the 2-digit PSECT number of the 
current PSECT immediately follows the address. For example, 

000100'02 

For a LOC or RELOC pseudo-op, only the address to which the 
location counter is set is given; the next word of code will 
be assembled at that address. 

4. The assembled binary code (if any) in one of eight formats. 

Fullword: all zeros with number sign (000000000000#) , 
showing that a fullword Polish fixup is required 
for the word of code. 

Halfword: two 18-bit bytes. Each halfword can be 
followed by an apostrophe (') to indicate that it 
is relocatable, or by a pound sign (#) to indicate 
that a Polish fixup is required for it. When you 
use the .HWFRMT pseudo-op, all code is listed in 
halfword format. 

Instruction: 9-bit op-code; 4-bit accumulator code; 
1-bit indirect code; 4-bit index; 18-bit address. 

Input/output: 3-bit I/O code; 7-bit device code; 
3-bit operand; 1-bit indirect code; 4-bit index; 
18-bit address. 

Byte pointer: 6-bit byte position; 6-bit byte size; 1 
unused bit; 1-bit indirect code; 4-bit index; 
18-bit address. 

ASCII: five 7-bit bytes; one unused bit. 

SIXBIT: six 6-bit bytes. 
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BYTE: binary representation of specified bytes. Bytes 
appear on the program listing only to the extent 
that available horizontal space permits. For 
example, 36 1-bit bytes cannot be represented as 
individual bytes on the listing. Any halfword byte 
containing an address can be flagged by an 
apostrophe ( ' ) or by a pound sign (#) . See the 
halfword format above. 

OPDEF or assignment: one or two 18-bit bytes, as 
needed. 



These examples show some code in each format: 



000056' 000000000000* 



B=A+C 



000057' 000001 000017' 
000060' 000017 000001 



IrrTAGl 
AC17»»1 



JHslfword 
JHslfword 



000061' 255 01 00 000100 
000062' 255 01 00 000100 



JFOV 100 
JFCL IrlOO 



; Instruction 
» Instruction 



000063' 7 114 04 1 04 001037' 
000064' 7 110 20 1 05 000004 



DATAI CDR»eNVR(4) J I/O 
CONO CDPfe4(5) fI/0 



000065' 21 06 00 000067' Pi: 
000066' 44 10 00 000070' P2: 



POINT 6»B1»18 
POINT 8fB2 



JByte pointer 
yB<:^te pointer 



000067' 07 00 01 000000 Bl : 
000070' 006 004 002 000 00 B2: 



BYTE (6)7f0fl JByte 
BYTE (8)6>4»2f0 ?Byte 



017000 000000 
026000 000000 



OPDEF Zini7B83 f OPDEF 
OPDEF Z2C26B8D ? OPDEF 



000071' 061 062 063 064 065 
000072' 101 102 103 104 105 



ASCII /12345/ JASCII 
ASCII \ABCDE\ > ASCI I 



000073' 21 22 23 24 25 26 
000074' 41 42 43 44 45 46 



SIXBIT /123456/ rSIXBIT 
SIXBIT \ABCDEF\ r'SIXBIT 



An apostrophe (') shows the code as relocatable. The 
examples show relocatable values in the right half of some 
words. The left half can also be relocatable. 

An asterisk (*) shows a symbol to be EXTERNAL or undefined. 

A number sign (#) shows that a Polish expression is required 
to resolve the value. 

5. Source statements and comments. 

If the assembler finds errors in a line of text, it suffixes one or 
more letters to the sequence number as error codes. These error codes 
are discussed in Chapter 8. A code is not repeated for multiple 
errors of the same type in a line. 
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At the end of the listing, the asselbler gives the total number of 
errors, followed by break addresses. The program break is the largest 
relocatable address assembled, plus 1. The absolute break is the 
largest absolute address assembled. The high-segment break is the 
largest high-segment address assembled For a program with PSECTs, 
the break for each PSECT is also given. 

The listing gives CPU time in the form mmrss.sss where mm is minutes 
and ss.sss is seconds. Core used is given in P's; one P is 512 words 
(1000 octal) . 

In the symbol table at the end of the listing, some symbols may have 
the following codes: 

ent result of ENTRY pseudo-op 

ext EXTERNAL symbol 

int INTERNAL symbol 

pol defined in terms of EXTERNAL symbols 

sen suppressed result of ENTRY pseudo-op 

sex suppressed EXTERNAL symbol 

sin suppressed INTERNAL symbol 

spd suppressed for debugger 

udf undefined symbol 

If you use the /C switch with MACRO, you can generate three additional 
tables in the program listing. The /C switch directs MACRO to 
generate the listing file in a format suitable for input to CREF, the 
cross-referencing program. This is a .CRF file rather than the usual 
.LST file. 

After assembly, the .CRF file can be used as input to CREF, and the 
output is the cross-referenced .LST file. This file contains the 
program listing and symbol table as described above. In addition, it 
has a cross-referenced symbol table, a table of macros and OPDEFs, 
and, if you use the /O switch with CREF, a cross-referenced table of 
opcodes and pseudo-ops. 

The cross-referenced symbol table lists each user-defined symbol 
(except macros, OPDEFs, and SYN symbols), and lists the sequence 
number of each line containing the symbol. 

The table of mactos and OPDEFs shows each reference to macros, OPDEFs, 
and SYN symbols. 

The opcode table shows each reference to MACRO-def ined opcodes and 
pseudo-ops, giving the sequence number of each line containing the 
opcode or pseudo-op. 
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6.2 THE BINARY PROGRAM FILE 

MACRO outputs the binary program file to the device you specify, 
usually a storage device. The default device is a disk. " Most of the 
file is the binary expansion of your program instructions. These 
instructions are formatted into groups called REL Blocks; each block 
is labeled so that LINK can recognize it. Details of this formatting 
and labeling are discussed in the LINK Reference Manual . 

A relocatable binary program file can be stored on any input/output 
device. The output format is not related to either block types or 
logical divisions of the device. 



6.3 THE UNIVERSAL FILE 

THE UNIVERSAL file is output only if the source file contains the 
UNIVERSAL pseudo-op. (See the discussions at UNIVERSAL in Chapter 3 
and in Section 9.2.) 

A UNIVERSAL file contains only symbols and definitions. These 
definitions are available to any program, and can be obtained by using 
the SEARCH pseudo-op. 
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USING THE ASSEMBLER 

To assemble a MACRO program, use one of the following: 

1. The operating system command COMPILE (See the User's Guide 
for details.) 

2. The $MACRO card for the BATCH program (See the BATCH 
Reference Manual . ) 

3. The MACRO command level 

To assemble a program in the command level of MACRO, type the word 
MACRO to the system. The system then runs MACRO, which responds with 
an asterisk (*) : 

©MACRO 
* 

Then define files for MACRO by typing a command of the form 

relf ile,listf ile=sourcef ile , . . . , source file 
where: 

relfile is a filespec for the binary program output file. 

listfile is a filespec for the program listing output file. 

each sourcefile is a filespec for a source program input file; 
MACRO assembles source files in the order given. 

The default device for each file is DSK:, but you can override this by 
prefixing devicecode: to any of the files. Default file types are 
.REL for relfile, .LST for listfile (.CRF if you use the /C switch), 
and .MAC for each sourcefile. You can override these by suffixing a 
file type to any of the files. 

You can specify a directory for any of these files by suffixing a 

project-programmer number (PPN) in square brackets. (See Appendix G.) 

You can set switches by suffixing /char or (char) to a file, where 

char is a switch code. Switch codes and their meanings are given in 
Table 7-1. 
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You can suppress the binary file by omitting its file specification 
(but keeping the comma) : 

,listf ile=sourcef ile, . . . ,sourcef ile 

You can suppress the listing file by omitting its file specification 
and the comma: 

relf ile=sourcef ile, . . . ,sourcef ile 

You can suppress both output files by omitting their file 
specifications (but keeping the equal sign): 

=sourcef ile, . . . ,sourcef ile 

You can access an indirect file (containing valid asterisk-level MACRO 
command strings) by typing a command of the form: 

§indirectf ile 

where indirectfile is the file specification for the file. 

Examples: 



DATE,DATE=DATE 

DATE=DATE 

,DATE=DATE 

=DATE 

DATE,TTY:=DATE 
DATE,DATE=TTY: 
DATE , DATE=TTY : , DSK : DATE 



Assemble source file DATE, MAC from disk 
into binary program file DATE.REL on 
disk, and put the listing in file 
DATE.LST on disk. 

No listing file. 

No binary file. 

No binary or listing file. Print all 
error diagnostics on the terminal. 

Send the listing to the terminal. 

Accept source code from the terminal. 

Accept source code from the terminal 
(usually symbol definitions) , followed 
by more source code from the disk. 
Notice that DSK must be specified; 
otherwise, TTY would be assumed. 



NOTE 

Many programmers use the following 
commands to check assembly of short code 
sequences: 

*»tty:=tty: 

PASS2 

This displays the assembled code line by 
line as you type it in. 
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Table 7-1 
MACRO Switch Options 



Switch Meaning 



/A Advance magnetic tape reel by one file. The /A 
switch must immediately follow the device to which 
the switch refers. 

/B Backspace magnetic tape reel by one file. The /B 
switch must immediately follow the device to which 
the switch refers. 

/C Produce listing file in a format acceptable as input 
to CREF. Unless the filename is given, CREF.CRF is 
assumed; if no file type is given, .CRF is assumed; 
if no listing device is specified, DSK: is assumed. 

The /C switch can be used only with the file 
specification for the program listing file; it must 
appear between the comma and the equal sign. 

/E List macro expansions (same as LALL pseudo-op) . 

/F Output binary listing in multiformat (same as .MFRMT 
pseudo-op) . 

/G Output binary listing in halfword format (same as 
.HWFRMT pseudo-op) . 

/H Print HELP text (list of switches and explanations) . 

/L Reinstate listing (same as LIST pseudo-op) . 

/M List only the call and binary produced in a macro 
expansion (same as SALL pseudo-op) . 

/N Suppress error printouts on the terminal. 

/O End literal with CR-LF or right square bracket (same 
as MLOFF pseudo-op) . 

/P Increase the size of the pushdown list. This switch 
can appear as many times as desired. The pushdown 
list is initially set to a size of 80 (decimal) 
locations; each /P increases the size by 80 
(decimal) . /P must appear on the left of the =. 

/Q Suppress Q (questionable) warning errors on the 
listing. /Q must appear on the left of the =. 



(Continued on next page) 
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Table 7-1 (Cont.) 
MACRO Switch Options 



Switch Meaning 



/S Suppress listing (same as XLIST pseudo-op) . 

/T Skip to the logical end of the magnetic tape. The /T 
switch must immediately follow the device to which 
the switch refers. 

/U Do not generate a .UNV file on DSK. The /U switch 
must appear immediately after the specification for 
the binary program file; that is, it must appear 
between the file specification and the comma. 

/W Rewind the magnetic tape. The /W switch must 
immediately follow the device to which the switch 
refers. 

/X Suppress listing of macro expansions (same as XALL) . 
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ERRORS AND MESSAGES 

MACRO has three kinds of messages: 

1. Informational messages 

2. Single-character error codes 

3. MCRxxx messages (where xxx is a 3-letter mnemonic code) 

8.1 INFORMATIONAL MESSAGES 

MACRO'S informational messages are printed at the foot of the program 
listing. These messages and their explanations are given in Table 
8-1. 
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Table 6-1 
MACRO Informational Messages 



Message 


Explanation 


ABSLUTE BREAK 


The highest absolute address over 137. 


CORE USED 


The size of the low segment used to 




assiemble the source program. 


CPU TIME USED 


The CPU time for assembly in minutes and 




seconds. 


ERRORS DETECTED 


The number of errors detected by MACRO 




during assembly (errors marked on the 




listing by single-character codes other 




than Q) . 


HI-SEG. BREAK 


The length of the high segment. 


PROGRAM BREAK 


The length of the low segment. 


PSECT n BREAK 


The length of PSECT n. 


UNASSIGNED DEFINED 


Undefined symbol; treated as EXTERNAL. 


AS IF EXTERNAL 




WARNINGS GIVEN 


The number of Q errors found. Processing 




is terminated if under BATCH. 
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8.2 SINGLE-CHARACTER ERROR CODES 

Single-character error codes are printed in the program listing near 
the left margin of the line where the error occurs. If more than one 
kind of error occurs in the same line, more than one character will be 
printed; if more than one error of the same kind occurs in the line, 
the code is printed only once. 

Codes for M, P, V, and X errors are typed during Pass 1. 

If you use CREF to produce a cross-referenced listing file, all the 
single-character error codes will appear in the cross-reference table 
as %....x, where x is the code character. 

Table 8-2 gives the single-character error codes and their 
explanations. 



8-3 



ERRORS AND MESSAGES 



Table 8-2 
MACRO Single-Character Error Codes 



Code 




Explanation 


A 


Argument error in pseudo-op. This is a broad class of 
errors that can be caused by an improper argument in a 
pseudo-op. The A errors include: 




1. 


Symbol used is improperly formed. 




2. 


IFIDN comparison string is too large. 




3. 


OPDEF of macro or SYN. 




4. 


Invalid SIXBIT character. 




5. 


Byte size in BYTE more than 36. 




6. 


RADIX50 code not absolute. 




7. 


End of line of IF reached before < character seen. 




8. 


Assignment made in an address field; for example, 
MOVEI A=10. (However, MOVEI <A=10> is valid.) 




9. 


Assignment of a label; for example, TAG: TAG=1. 




10. 


Missing symbol in SYN. 




11. 


Unknown symbol in SYN. 




12. 


Missing right parenthesis in an index. 




13. 


Missing left parenthesis in a BYTE statement. 




14. 


No comma after repeat count. 




15. 


IRP or IRPC not in a macro. 




16. 


Argument for IRP or IRPC is not a dummy symbol; for 
example, DEFINE GO (A) IRP B. 




17. 


IRP or IRPC argument is a created symbol. 




18. 


STOPI not in IRP or IRPC. 


D 


Mult 
that 
defi 


iply defined symbol. The statement contains a tag 
refers to a multiply defined symbol. The first 
nition is used for assembling the statement. 



(Continued on next page) 
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Table 8-2 (Cont.) 
MACRO Single-Character Error Codes 



Code Explanation 



E Improper use of an EXTERNAL symbol. The E errors include: 

1. Symbol both EXTERNAL and internal. 

2. EXTERNAL symbol used as accumulator register address. 

3. EXTERNAL symbol used with IF. 

4. EXTERNAL symbol used as address for LOC, RELOC , PHASE, 
HISEG, or TWOSEG. 

5. EXTERNAL symbol used for array name or size in ARRAY. 

6. EXTERNAL symbol used as REPEAT count. 

L Literal generates less than 1 or more than 99 words of 
data. 

M Symbol defined more than once; retains its first 
definition. If a symbol is first defined as a variable 
and later as a label, it retains the label definition. 
This error can be caused by multiple appearances of TITLE, 
or TITLE with UNIVERSAL. 

N Number error. The N errors include: 

1. Number exceeds the permitted range. 

2. B shift not absolute. 

3. Digits exceed current radix. If radix is 8, the 
single character 9 is acceptable but the number 19 is 
not acceptable. 

4. Character after up-arrow not B, 0, F, L, D, ! , or -. 

5. Illegal expression after E. 

Operation code undefined. It is assembled as, zeros. 

P Phase error. In general, the assembler generates the same 
number of program locations in Pass 1 and Pass 2. Any 
discrepancy causes a phase error. 

Phase errors can be caused by incorrect literal 
allocation. 

If a symbol is used as a macro to generate code in Pass 1, 
and is used as a label in Pass 2, a phase error can occur. 

A relocatable label that is defined in a literal and then 
used in an arbitrary expression; MACRO generates a Polish 
expression instead of treating the label as EXTERNAL. I 

(Continued on next page) 
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Table 8-2 (Cont.) 
MACRO Single-Character Error Codes 



Code 




Explanation 




Q 


Questionable. This is a broad class of warnings in which 
the assembler finds ambiguous language. Statements 
causing Q errors may not generate correct code. The 
errors include: 




1. 


Too many ASCII characters in double quotes ("). 
the first five are used. 


Only 




2. 


Too many SIXBIT characters. Only the first six 
used. 


are 




3. 


Value too large; high-order bits are lost. 






4. 


Illegal expression after E. 






5. 


Illegal control character. 






6. 


Comma detected after all required fields filled; 
example, MOVE 1,2,. 


for 




7. 


HISEG or TWOSEG found after relocatable 
assembled. 


code 




8. 


Instruction memory address operand does not 
either all O's or all I's in its left half; 
example, 1,,0 or -4,,-l. 


have 
for 




9. 


More than 18-bit values used in XWD. 




R 


Relocation error. The R errors include: 






1. 


Expression neither absolute nor relocatable. 






2. 


LOC or RELOC used improperly. 






3. 


Relocatable BLOCK size given. 






4. 


Relocatable accumulator address given. 




S 


PSECT usage error. The S errors include: 






1. 


More than 64 distinct PSECT names used. 






2. 


More than 16 levels of PSECT nesting used. 






3. 


PSECT name given with .ENDPS is not the name of 
current PSECT. 


the 


U 


Und 


efined symbol. 




V 


Symbol used to control the assembler is undefined, 
the definition precede the reference. 


Make 


X 


Error in defining or calling a macro during Pass 1. 
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8.3 MCRxxx MESSAGES 

The MCRxxx messages are issued to the terminal during assembly. (The 
XXX represents a 3-letter code.) 

Any MCRxxx message that is preceded by a question mark is normally 
fatal under batch processing. A few MCRxxx messages are 
informational; these are issued within square brackets. 

Table 8-3 gives all the MCRxxx messages. Each 3-letter code and its 
message are printed in boldface type. For some messages, an 
explanation is printed in lightface type. 
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Table 8-3 
MCRxxx Messages 



Code Message and Explanation 



ATS LINES/PAGE ARGUMENT TOO SMALL 

The argument given must be greater than three to allow space 
for the page heading. 

CAP CORE ALLOCATION PROBLEM WITH MEMORY-RESIDENT UNIVERSALE 

UNIVERSAL programs assembled with the /U switch must have 
the same output specifications as succeeding files. (See 
the pseudo-op UNIVERSAL in Chapter 3.) However, if none of 
the memory-resident UNIVERSALE are to be searched by 
subsequent files in the command sequence, you can clear the 
UNIVERSALs and force the needed memory allocation by typing 
CTRL/C, followed by START. 

CPU CANNOT FIND UNIVERSAL 

Correct the request for the UNIVERSAL file, or assemble the 
required UNIVERSAL file. 

CME COMMAND ERROR 

The last command string contains an error. 

CTL COMMAND LINE TOO LONG 

The last input command string contains more than 200 
characters. 

DNA DEVICE NOT AVAILABLE 

The specified device cannot be initialized because it is in 
use. 

ECF ERROR READING COMMAND FILE 

This is a file status error. 

EPl END OF PASS 1 

Manual input is required to begin Pass 2 because input is 
from cards or terminal. 

EPP EXPRESSION PARSING PROBLEM 

An expression was misinterpreted because MACRO interpreted a 
slash as a division operator, or a hyphen as a subtraction 
operator. 

ERU UNEXPECTED END-OF-FILE READING UNIVERSAL FILE 

EWE ERROR WHILE EXPANDING 

MACRO has an internal error in expanding a macro. Rewrite 
the macro, and submit a Software Performance Report. 



(Continued on next page) 
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Table 8-3 (Cont.) 
MCRxxx Messages 



Code Message and Explanation 



FNF FILE NOT FOUND 

IBL INPUT BLOCK TOO LARGE DEVICE 

An input block from the specified device is too large. 
ICP INPUT CHECKSUM OR PARITY ERROR DEVICE 

This is a hard-data error. 
IDE INPUT DATA ERROR DEVICE 

This is a hard-data error. 
ISC ILLEGAL SYNTAX IN CONDITIONAL OR REPEAT 
ISD ILLEGAL SYNTAX IN MACRO DEFINITION 

The macro is improperly defined. 

ISI ILLEGAL SYNTAX IN [IRP or IRPC] INSIDE MACRO 

ISR ILLEGAL SYNTAX IN REPEAT 

LFO LST FILE OPEN ERROR 

LNF LOAD THE NEXT FILE 

The command string specifies the next file device as card 
reader or terminal. Input the file through the appropriate 
device. 

LTL LITERAL TOO LONG 

MDE MONITOR DETECTED SOFTWARE INPUT ERROR DEVICE 

The input file is not in a valid mode. 
MPA MISSING CLOSE PAREN AROUND ARG LIST 
NEC INSUFFIBIENT CORE 

Not enough memory is available to assemble the program. 
NES NO END STATEMENT ENCOUNTERED ON INPUT FILE 
NUF NOT A REAL UNIVERSAL FILE 

No such UNIVERSAL file was found. 



(Continued on next page) 
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Table 8-3 (Cont.) 
MCRxxx Messages 



Code Message and Explanation 

OBL OUTPUT BLOCK TOO LARGE DEVICE 

This is a file-status error. 
OCP OUTPUT CHECKSUM OR PARITY ERROR DEVICE 

This is a hard-data error. 
ODE OUTPUT DATA ERROR DEVICE 

This is a hard data error, 
OQE OUTPUT QUOTA EXCEEDED ON DEVICE 

OUP UNIVERSAL PILE DEFAULT ARGUMENTS LOST, REASSEMBLE 
PDL PDP OVERFLOW, TRY /P 

See the /P switch in Table 7-1. 
PET INPUT PHYSICAL END OF TAPE DEVICE 
PGE PRGEND ERROR 

See the PRGEND pseudo-op for proper use of PRGEND. 

PTC POLISH TOO COMPLEX 

A Polish expression is too complex for MACRO to handle. 
Restructure or split the expression. 

RFO .REL FILE OPEN ERROR 

SOC STATEMENT OUT OF ORDER .COMMON 

The .COMMON pseudo-op must precede all statements that 
generate code, and all references to the COMMON block. 

STO SEARCH TABLE OVERFLOW, CANNOT SEARCH UNIVERSAL 

TMO TOO MANY UNIVERSALE 

Too many UNIVERSAL files are being searched. The number 
permitted is an assembly parameter; it can be increased by 
reassembling MACRO. 

UVS UNIVERSAL VERSION SKEW, REASSEMBLE UNIVERSAL 

The UNIVERSAL file was assembled with a later version of 
MACRO than you are using now. Reassemble the UNIVERSAL 
file. 

UWU UNABLE TO WRITE UNIVERSAL FILE 

WLE OUTPUT WRITE-LOCK ERROR DEVICE 
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CHAPTER 9 
PROGRAMMING CONSIDERATIONS 



The previous chapters of this manual define the MACRO language 

elements. In particular, the pseudo-op definitions in Chapter 3 

define many of MACRO'S most important features. However, the 

usefulness of some pseudo-ops can be seen only in the context of a 
"family" of pseudo-ops. 

In this chapter, we discuss three such families of pseudo-ops. The 
programming features concerned are: 

1. Program segmentation 

2. UNIVERSAL files 

3. Conditional assembly 



9.1 PROGRAM SEGMENTATION 

MACRO'S relocation counters can accommodate three types of programs: 

1. A single-segment program uses only one relocation counter. 

2. A two-segment program also uses one relocation counter, and 
is characterized by its use of the TWOSEG pseudo-op. 

3. A program with PSECTS can use many relocation counters, and 
is characterized by its use of the .PSECT and .ENDPS 
pseudo-ops. 



9.1.1 Single-Segment Programs 

A single-segment program uses only one relocation counter. This 
counter can be used to assign any address from to 777777. The 
initial setting of the counter is 0. 

As MACRO assembles your program, it places code and data at the 
address given by the current value of the relocation counter, 
incrementing the counter's value for each word assembled. 

For example, a statement can require assembly of one word of code, 
incrementing the relocation counter by 1. Another statement can 
require assembly of five words of code, incrementing the relocation 
counter by 5. Still another statement may not generate code, leaving 
the relocation counter unchanged. 
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You can reset the value of the relocation counter by using the 
pseudo-op RELOC with an argument. For example, using RELOC A sets the 
value of the relocation counter to the value of A. 

In the following example, 100 words are allocated for a table, 
incrementing the relocation counter by 100. Then the table length is 
calculated as TABLEN. A RELOC TABLE returns to the top of the table, 
where the first three words are initialized. Finally a RELOC 
TABLE+TABLEN sets the relocation to the foot of the table to continue 
assembly. 



000000' 

000100 
000000' 

000000' 000000 000001 
000001' 000000 000002 
000002' 000000 000003 
000100' 



table: block loo 



TABLEN=» -TABLE 
RELOC TABLE 
EXP ir2f3 



^Allocate table 
rTable length 
J Top of table 
Jlnit first 3 



RELOC TABLE+TABLEN J Continue 



9.1.2 Two-Segment Programs 

By using the TWOSEG pseudo-op, you can divide your program into a high 
segment and a low segment. This pseudo-op must precede any statement 
in your program that generates code. 

The TWOSEG pseudo-op tells MACRO that there will be two segments, and 
MACRO generates a REL Block Type 3, which tells LINK to expect two 
segments for loading. 



You can use TWOSEG either with or without an address argument, 
are important differences between the two: 



There 



1. TWOSEG without an argument specifies that the high segment 
begins at the address 400000. The initial value of the 
relocation counter is at the address in the low segment. 

2. TWOSEG with an argument specifies that the high segment 
begins at the given address, and further specifies that the 
initial value of the relocation counter is that address. 
(The given address is reduced to the next lower multiple of 
2000 octal; if this result is 0, MACRO treats the TWOSEG as 
if no argument were given.) 

The high-segment starting address divides all code into two segments. 

MACRO and LINK consider all code at addresses above the high-segment 

address to be in the high segment, and all other code to be in the low 
segment. 

MACRO always remembers the value the relocation counter had before the 
last RELOC found. (This stored value is initially 0.) 

Therefore in a two-segment program, you can begin in one segment, and 
then RELOC to the other. From then on, you can switch segments simply 
by using RELOC with no argument. MACRO will begin assigning addresses 
at the first unused location in the opposite segment. 
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For example, 

400000' 
000000' 
000001' 
400000' 
400000' 
400001' 
000002' 
000002' 
000003' 
400002' 
400002' 
400003' 



000000 
000000 

000000 
000000 

000000 
000000 

000000 
000000 



000001 
000002 

000003 
000004 

000005 
000006 

000007 
000010 



TUOSEG 
EXP lf2 

RELOC 400000 
EXP 3rA 

RELOC 
EXP 5f6 

RELOC 
EXP 7»10 



JLo~sed 
JHi-sed 

JLo-sed 
»Hi-sea 



9.1.3 Programs With PSECTs 

You can construct a program having up to 
.PSECT and .ENDPS pseudo-ops. These 
among program segments (PSECTs) . 



64 segments by using the 
pseudo-ops control switching 



Each PSECT has its own relocation counter; each is separately 
relocated at load time. Therefore a program with two PSECTs is 
different from a two-segment program in that the PSECTed program has 
two relocation counters, while the two-segment program has only one. 

The pseudo-op .PSECT specifies that code should be assembled for a 
given PSECT. For example, .PSECT A specifies that code is to be 
assembled in the program segment (PSECT) called A. The pseudo-op 
.ENDPS ends assembly in the current PSECT. 

PSECTs can be nested up to 16 levels. In a nested PSECT, the .ENDPS 
pseudo-op begins assembly in the next outer PSECT; in an unnested 
PSECT, .ENDPS begins assembly in the blank PSECT. (You can think of 
the blank PSECT as being outside of all your explicitly declared 
PSECTs.) 

Here is an example showing three PSECTs (A, B, and C) : 



000000 '00 
000001 '00 
OOOOOO'Ol 
000000 '01 
000001 '01 
000000 '02 
000000 '02 
000001 '02 
000002'01 
000002 '01 
000003'01 
000002'00 
000002 '00 
OOOOOS'OO 
000000 '03 
000000'03 
000001 '03 
000004'00 
000002'02 
000002'02 
000003 '02 
000004 '00 



000000 
000000 

000000 
000000 

000000 
000000 

000000 
000000 

000000 
000000 

000000 
000000 



000000 
000000 



000001 
000002 

000003 
000004 

000005 
000006 

000007 
000010 

000011 
000012 

000013 
000014 



000015 
000016 



EXP 1»2 

♦PSECT A 
EXP 3»4 

♦PSECT B 
EXP 5>6 

♦ENDPS B 
EXP 7»10 

♦ENDPS A 
EXP 11»12 

♦PSECT C 
EXP 13»14 

♦ENDPS C 
♦PSECT B 
EXP 15»16 

♦ENDPS B 



fBlsnk PSECT 
rlst PSECT 

J 2nd PSECT (nested) 

J 1st PSECT 

; Blank PSECT 

53rd PSECT 



5 Blank PSECT 
?2nd PSECT 



f Blank PSECT 
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In the example, the blank PSECT surrounds everything. Embedded in the 
blank PSECT are: 

1. PSECT A (which also nests some of PSECT B) 

2. PSECT C 

3. Another segment of PSECT B 

Each PSECT used in a program generates the PSECT name as a global 
symbol. At load time, this symbol will take the value of the origin 
specified for the PSECT. 

When LINK loads your program, all the parts of the same PSECT are 
loaded together. These parts can be in more than one program, or in 
more than one file. For details of LINK'S handling of PSECTs at load 
time, see the LINK Reference Manual. 



9.2 UNIVERSAL FILES 

A UNIVERSAL file contains direct-assignment symbol definitions. The 
symbols defined can have any attributes. 

A UNIVERSAL file is convenient because it can contain definitions that 
you want for many programs. Those programs can then obtain the 
definitions by your use of the SEARCH pseudo-op. This searching adds 
to the assembly only those definitions that are needed; other 
definitions in the UNIVERSAL file are not used. 

To build a UNIVERSAL file from a MACRO source file, insert the 
pseudo-op 

UNIVERSAL filespec 

where the filespec gives the file for output of the UNIVERSAL file. 
This file will contain all the symbols and definitions given in the 
program. 

Another program can obtain these definitions if it contains the SEARCH 
pseudo-op: 

SEARCH filespec 

where filespec names the UNIVERSAL file. At the end of Pass 1 
assembly, MACRO will search the UNIVERSAL file for any undefined 
symbols. If a definition is found in the UNIVERSAL file, MACRO moves 
it into the symbol tables of the current program. 

For example, a UNIVERSAL file can contain definitions for register 
mnemonics: 

UNK^ERSAL REGS 



000000 


R0=0 


000001 


Rl = l 


000002 


R2=2 


000003 


R3=3 


000004 


Tl=4 


000005 


T2=5 


000016 


SP=16 


000017 


P=17 




END 
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Then another assembly can 
pseudo-op: 



obtain these by using the SEARCH REGS 



SEARCH REGS 



000000' 


000 


00 





00 


000000 


z 


ROr 


000001' 


000 


01 





00 


000000 


z 


Rlr 


000002' 


000 


02 





00 


000000 


z 


R2r 


000003' 


000 


03 





00 


000000 


z 


R3» 


000004' 


000 


04 





00 


000000 


z 


Tlf 


000005' 


000 


05 





00 


000000 


z 


T2f 


000006' 


000 


16 





00 


000000 


z 


SP» 


000007' 


000 


17 





00 


000000 


z 


P» 



A UNIVERSAL file can contain definitions for any user-defined symbols. 
You may find it convenient to build UNIVERSAL files containing macros, 
OPDEFs, and direct-assignment symbols that you use often in your 
programs. 



An example of a UNIVERSAL program appears in the program 
Appendix D. 



examples in 



9.3 CONDITIONAL ASSEMBLY 

Using conditional assembly in your programs can make programming 
easier, and can make your assembled programs shorter. The pseudo-ops 
used for conditional assembly are IRP, IRPC, STOPI, .IF, .IFN, and the 
IFx group. IRP, IRPC, and STOPI are discussed fully in Chapter 3 and 
Section 5.6. 

We will confine the discussion here to a few classic uses of the 
remaining conditional assembly pseudo-ops. 

The first of these is the use of IFNDEF to establish default switch 
settings for a program. The example here is from the MACRO program 
itself, and concerns assembly of F40-switch-dependent symbols. 

Near the beginning of the code, MACRO has the statement: 

IFNDEF F40 <F40==0> 

This statement has effect only if the symbol F40 is not defined, in 
which case the statement F40==0 is assembled. This sets the F40 
switch to "off." 

But if a file defining F40 is assembled with (and before) the MACRO 
source file, then the statement F40==0 is not assembled, leaving the 
"outside" definition in force. 

Therefore the statement IFNDEF F40 <F40==0> serves as a default 
definition for F40, and this default is used only if no other 
definition overrides it. 

Another application of conditional assembly is connected with the 
symbol F40. In MACRO'S program segments on symbol searching, some 
symbols will be defined (and therefore found in the search) only if 
the F40 switch is "on." 
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Here is how MACRO'S code handles these symbols. There is a code 
sequence as follows: 

? MACRO TO HANDLE F40 UUOS 

IFE FAOf^ 

DEFINE XF (SBfCD) <» J NULL MACRO 

IFN F40><SYN X>XF> rUSUAL X MACRO 

The "usual X macro" is merely a macro to set up symbols to be defined 
and the code to assemble on finding them. The macro XF will be used 
to handle definitions for F'40 UUOs. 

Now if the F40 switch is on, the macro XF is made synonymous with the 
macro X, and the F40 UUOs are defined in the same way as other 
operators. But if the F40 switch is off, XF is made a null macro so 
that all the F40 UUOs are ignored during assembly and are not defined 
to MACRO. 

The assembly of the F40 UUOs depends on the value of the F40 switch, 
and the value of the switch depends on its definition. If MACRO had 
no IFNDEF F40 statement, an "outside" file would have to define the 
switch at every assembly of MACRO. But the default definition allows 
assembly of MACRO alone, and the outside file is needed only to turn 
the switch on. 

Examples of conditional assembly are shown in the program examples in 
Appendix D. 
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APPENDIX A 
MACRO CHARACTER SETS 



Table A-1 gives the 101 ASCII characters allowed in MACRO and their 
octal ASCII codes; the 64 SIXBIT characters and their octal SIXBIT 
codes; and the 40 RADIX50 characters and their octal RADIX50 codes. 

Table A-1 
MACRO Character Sets 







ASCII 


SIXBIT 


RADIX50 


Character 


Code 


Code 


Code 


(horizontal tab) 


Oil 






(linefeed) 




012 






(vertical 


tab) 


013 






(formfeed) 




014 






(carriage- 


return) 


015 






(CTRL/Z) 




032 






(CTRL/_) 




037 






(blan 


k) 


040 


00 


00 


! 




041 


01 




u 




042 


02 




# 




043 


03 




$ 




044 


04 


46 


% 




045 


05 


47 


1 




046 
047 


06 
07 




( 




050 


10 




) 




051 


11 




* 




052 


12 




+ 




053 


13 




/ 




054 


14 




- 




055 


15 




. 




056 


16 


45 


/ 




057 


17 





(Continued on next page) 
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Table A-1 (Cont. ) 
MACRO Character Sets 





ASCII 


SIXBIT 


RADIX50 


Character 


Code 


Code 


Code 





060 


20 


01 


1 


061 


21 


02 


2 


062 


22 


03 


3 


063 


23 


04 


4 


064 


24 


05 


5 


065 


25 


06 


6 


066 


26 


07 


7 


067 


27 


10 


8 


070 


30 


11 


9 


071 


31 


12 


: 


072 


32 




• 


073 


33 




< 


074 


34 




= 


075 


35 




> 


076 


36 




? 


077 


37 




(§ 


100 


40 




A 


101 


41 


13 


B 


102 


42 


14 


C 


103 


43 


15 


D 


104 


44 


16 


E 


105 


45 


17 


F 


106 


46 


20 


G 


107 


47 


21 


H 


110 


50 


22 


I 


111 


51 


23 


J 


112 


52 


24 


K 


113 


53 


25 


L 


114 


54 


26 


M 


115 


55 


27 


N 


116 


56 


30 





117 


57 


31 


P 


120 


60 


32 


Q 


121 


61 


33 


R 


122 


62 


34 


S 


123 


63 


35 


T 


124 


64 


36 


U 


125 


65 


37 


V 


126 


66 


40 


W 


127 


67 


41 



(Continued on next page) 



A-2 



MACRO CHARACTER SETS 



Table A-1 (Cont.) 
MACRO Character Sets 





ASCII 


SIXBIT 


RADIX50 


Character 


Code 


Code 


Code 


X 


130 


70 


42 


Y 


131 


71 


43 


Z 


132 


72 


44 


[ 


133 


73 




\ 


134 


74 




] 


135 


75 




^ 


136 


76 




— 


137 


77 




a 


141 






b 


142 






c 


143 






d 


144 






e 


145 






f 


146 






g 


147 






h 


150 






i 


151 






J 


152 






k 


153 






1 


154 






m 


155 






n 


156 






o 


157 






P 


160 






q 


161 






r 


162 






s 


163 






t 


164 






u 


165 






V 


166 






w 


167 






X 


170 






y 


171 






z 


172 




_„ — , ,- 
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MACRO SPECIAL CHARACTERS 



Characters and combinations having special interpretations in MACRO 
are given in Table B-1. These interpretations apply only in the 
contexts described. In particular, they do not apply within text 
strings or comment fields. 

For each usage of special characters, a cross-reference to a text 

discussion is given in the rightmost column of the table. For 

references to pseudo-ops, only the pseudo-op name is given; all 
pseudo-ops are discussed in alphabetical order in Chapter 3. 
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Table B-1 
Interpretations of Special Characters 



DO 
I 
tvi 



Characters 


Context 


Form 


Interpretation 


Discussed in 
Section 


B 


between two 

integer 

expressions 


mBn 


causes the 
of m to be 
bit at bit 


binary representation 
placed with rightmost 
n (decimal) . 


2.2.6 


"B 


before integer 
expression 


-^Bn 


shows thatf 


n is a binary number. 


2.2.2 


'^D 


before integer 
expression 


-^Dn 


shows that 


n is a decimal number. 


2.2.2 


E 


between floating- 
point decimal 
number and signed 
decimal integer 


fE+n 


multiplies 
+nth power 


f by the 
of 10. 


2.2.5 


'^F 


before integer 
expression 


"Fn 


shows that n is a fixed- 
point decimal number. 


2.2.4 


G 


after integer 


nG 


suffixes nine zeros to n. 


2.2.3 


K 


after integer 


nK 


suffixes three zeros to n. 


2.2.3 


'^L 


before decimal 

integer 

expression 


-^Ln 


generates the number of leading 
zeros in the binary representa- 
tion of n. 


2.2.8 


M 


after integer 


nM 


suffixes six zeros to n. 


2.2.3 



> 
n 

o 

CO 

*n 

M 

o 

M 

> 

O 

m 
> 

> 
o 

a 

CO 
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Table B-1 (Cont.) 
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Characters Context 



Form 



Interpretation 



before 


; integer 


'^On 


expression 




after 


symbol 


sym: 


after 


symbol 


sym: : 


after 


symbol 


sym: ! 


after 


symbol 


sym: : ! 



before end of 
line 

before end of 
line (usually 
in a macro) 

as expression 



embedded in 
numerals 



; text 
; ; text 



int. f r 



shows that n is an octal number. 



shows that sym is a label. 

shows that sym is a 
global INTERNAL label. 

shows that sym is a label, 

but not to be output by debugger 

shows that sym is a global 
INTERNAL label, but not to be 
output by debugger. 

shows that text is a comment. 



shows that text is a comment 
to be printed in the macro 
definition but not at call. 

generates current value of the 
location counter. 

shows that int.fr is a 
floating-point decimal number. 



Discussed in 
Section 



2.2.2 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 

2.4.2.1, 4.1, 4.5 
4.4, 4.5 
4.4, 4.5 

2.3, 4.6 
2.2.5 



3 
> 
O 

o 

w 
*n 
w 
n 

M 

> 
f 

o 

re 
> 

> 
o 

1-3 
M 

cn 
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I 



Characters 


Context 


Form 


Interpretation 


Discussed in 
Section 


f 


among numbers 
and symbols 


/ 


delimits operands, accumulator, 
arguments. 


4.3, 4.5 
5.1, 5.2 


1 1 


among numbers 
and symbols 


/ 1 


delimits a null macro argument. 


5.2, 5.5 


1 1 


between two 
expressions 


Ihw/ ,rhw 


delimits left halfword (Ihw) 
from right halfword (rhw) . 


2.5.4.1 


1 


between two 
expressions 


AIB 


generates the logical 
inclusive OR of A and B. 


2.5.2 


"! 


between two 
expressions 


A"!B 


generates the logical 
exclusive OR of A and B. 


2.5.2 


& 


between two 
expressions 


A&B 


generates the logical 
AND of A and B. 


2.5.2 


"- 


before expression 


"-A 


generates one's complement of value 
of A (logical NOT). 


2.5.2 


* 


between two 
expressions 


A*B 


generates product of A and B. 


2.5.1 


/ 


between two 
expressions 


A/B 


generates quotient of A by B. 


2.5.1 


+ 


between two 
expressions 


A+B 


generates sum of A and B. 


2.5.1 



3 
> 

o 

cn 
^d 
w 
o 

M 

> 

o 

EC 
> 

n 

t-3 

» 
cn 
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CO 

I 

U1 



Characters 


Context 


Form 


Interpretation 


Discussed in 
Section 


- 


between two 
expressions 


A-B 


generates difference of A and B. 


2.5.1 


- 


before an 
expression 


-A 


generates the two's complement 
of the value of A. 


2.2.1, 2.2.4, 
2.2.5 


CI II 

... 


around text 


"text" 


shows that text is a 7-bit ASCII 
string, to be right justified 
in field of five characters. 


ASCII, ASCIZ 


1 1 


around text 


•text' 


shows that text is a SIXBIT 
string, to be right justified 
in field of six characters. 


SIXBIT 


1 


adjoining dummy 
argument in 
macro body 


text 'darg 

or 
darg ' text 


concatenates passed argument to 
text at call to macro. 


5.4 


# 


after symbol 


sym# 


shows that sym is a variable 
symbol, whose address is usually 
at the end of the binary program. 


2.4.3 


## 


after symbol 


sym## 


shows that sym is a global 
EXTERNAL symbol. 


2.4.5.2 


\ 


prefixed to 
expression 
in macro call 


\expr 


directs that the argument passed be 
the string for the ASCII value of 
expr in the current radix. 


5.7.1 



3 
> 

n 

o 

en 

a 
o 

M 

> 

O 

a: 
> 

n 

1-3 

» 
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CO 

I 



Characters 


Context 


Form 


Interpretation 




Discussed in 
Section 


\' 


prefixed to 
expression 
in macro call 


X'expr 


directs that the argument passed 
the string whose SIXBIT code is 
the value of expr. 


be 


5.7.3 


\" 


prefixed to 
expression 
in macro call 


\"expr 


directs that the argument passed 
the string whose ASCII code is 
the value of expr. 


be 


5.7.3 


CTRL/_ 
(CONTROL- 
underscore) 


before CR-LF 


CTRL/_ 


continues argument to next line; 
not operate across end-of-macro. 


does 


5.2.1 


— 


between two 
expressions 


A B 


shifts the binary representation 

of A to the left B positions. 

(If B is negative, shift is to right.) 


2.2.6 


@ 


prefixed to 
address 


(iaddress 


sets bit 13 of the instruction word, 
indicating indirect addressing. 


4.7.1 


% 


1st character 

of dummy argument 

in macro definition 


%darg 


directs that %darg be replaced by a 
created symbol at macro call; MACRO 
will substitute a different symbol 
for it on each use of the macro. 


5.5.2 


( ) 




(...) 


encloses index field; encloses dummy 
arguments in macro definition; 
quotes characters for macro 
argument handling; swaps the two 
halves of enclosed value. 


4.7.1, 5.1 
5.2.2 



3: 
> 

» 
o 

CO 

nj 
a 
n 

M 

> 

o 

SB 
> 

O 

a 
w 

CO 
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Table B-l (Cont.) 
Interpretations of Special Characters 



DO 



Characters 


Context 


Form 


Interpretation 


Discussed 
Section 


1 in 


< > 




<. . .> 


nests expressions; encloses 
conditional assembly code; 
encloses code in REPEAT, IRP, 
and IRPC pseudo-ops; encloses 
macrobody in DEFINE pseudo-op; 
quotes characters for macro 
argument handling; forces 
evaluation of symbol. 


2.5.4 

IFx, .IF, .IFN, 
REPEAT, IRP, 
IRPC, DEFINE, 
5.1, 5.2.2 


[ ] 




[...] 


delimits literals; delimits argument 
in ARRAY, .COMMON, and OPDEF 
pseudo-ops; quotes characters 
for macro argument handling. 


2.3, ARRAY, 
.COMMON, OPDEF, 
5.2.2 


= 


between symbol 
and expression 


sym=exp 


assigns value of exp to sym. 


2.4.2.2, 


4.5 


== 


between symbol 
and expression 


sym==exp 


assigns value of exp to sym but 
sym is not output by debugger. 


2.4.2.2, 


4.5 


= : 


between symbol 
and expression 


sym=:exp 


assigns value of exp to sym and 
declares sym as global INTERNAL. 


2.4.2.2, 


4.5 


== : 


between symbol 
and expression 


sym==:exp 


assigns value of exp to sym and 
declares sym as global INTERNAL, 
but sym is not output by debugger. 


2.4.2.2, 


4.5 
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APPENDIX C 
MACRO-DEFINED MNEMONICS 



This appendix contains tables showing all of MACRO'S defined mnemonics 
and the code they generate. These mnemonics, together with the 
pseudo-ops and the special characters given in Appendix B, make up the 
entire MACRO language. 

NOTE 

Throughout this appendix, the following 
notes apply to the tables: 

* Indicates mnemonic defined only if MACRO 
is assembled with the KLIO switch on. 

** Indicates mnemonic defined only if MACRO 
is assembled with the KIIO switch on. 



C.l MACHINE INSTRUCTION MNEMONICS 

Table C-1 shows MACRO'S machine instruction mnemonics and the code 
assembled by each mnemonic. See Section 4.7 for a discussion of 
machine instructions used in programs. 



C-1 



MACRO-DEFINED MNEMONICS 



Table C-1 
Machine Instruction Mnemonics 



270 


00 00 


000000 


ADD 


303 


00 


00 


000000 


CAILE 


273 


00 00 


000000 


ADDB 


306 


00 


00 


000000 


CAIN 


271 


00 00 


000000 


ADDI 


310 


00 


00 


000000 


CAM 


272 


00 00 


000000 


ADDM 


314 


00 


00 


000000 


CAMA 


133 


00 00 


000000 


*ADJBP 


312 


00 


00 


000000 


CAME 


105 


00 00 


000000 


*ADJSP 


317 


00 


00 


000000 


CAMG 


404 


00 00 


000000 


AND 


315 


00 


00 


000000 


CAMGE 


407 


00 00 


000000 


ANDB 


311 


00 


00 


000000 


CAML 


410 


00 00 


000000 


ANDCA 


313 


00 


00 


000000 


CAMLE 


413 


00 00 


000000 


ANDCAB 


316 


00 


00 


000000 


CAMN 


411 


00 00 


000000 


ANDCAI 


400 


00 


00 


000000 


CLEAR 


412 


00 00 


000000 


ANDCAM 


403 


00 


00 


000000 


CLEARB 


440 


00 00 


000000 


ANDCB 


401 


00 


00 


000000 


CLEARI 


443 


00 00 


000000 


ANDCBB 


402 


00 


00 


000000 


CLEARM 


441 


00 00 


000000 


ANDCB I 


114 


00 


00 


000000 


*DADD 


442 


00 00 


000000 


ANDCBM 


117 


00 


00 


000000 


*DDIV 


420 


00 00 


000000 


ANDCM 


110 


00 


00 


000000 


**DFAD 


423 


00 00 


000000 


ANDCMB 


113 


00 


00 


000000 


**DFDV 


421 


00 00 


000000 


ANDCMI 


112 


00 


00 


000000 


**DFMP 


422 


00 00 


000000 


ANDCMM 


131 


00 


00 


000000 


DFN 


405 


00 00 


000000 


AND I 


111 


00 


00 


000000 


**DFSB 


406 


00 00 


000000 


ANDM 


234 


00 


00 


000000 


DIV 


253 


00 00 


000000 


AOBJN 


237 


00 


00 


000000 


DIVB 


252 


00 00 


000000 


AOBJP 


235 


00 


00 


000000 


DIVI 


340 


00 00 


000000 


AOJ 


236 


00 


00 


000000 


DIVM 


344 


00 00 


000000 


AOJA 


120 


00 


00 


000000 


**DMOVE 


342 


00 00 


000000 


AOJE 


124 


00 


00 


000000 


**DMOVEM 


347 


00 00 


000000 


AOJG 


121 


00 


00 


000000 


**DMOVN 


345 


00 00 


000000 


AOJGE 


125 


00 


00 


000000 


**DMOVNM 


341 


00 00 


000000 


AOJL 


116 


00 


00 


000000 


*DMUL 


343 


00 00 


000000 


AOJLE 


137 


00 


00 


000000 


DPB 


346 


00 00 


000000 


AOJN 


115 


00 


00 


000000 


*DSUB 


350 


00 00 


000000 


AGS 


444 


00 


00 


000000 


EQV 


354 


00 00 


000000 


AOSA 


447 


00 


00 


000000 


EQVB 


352 


00 00 


000000 


AOSE 


445 


00 


00 


000000 


EQVI 


357 


00 00 


000000 


AOSG 


446 


00 


00 


000000 


EQVM 


355 


00 00 


000000 


AOSGE 


250 


00 


00 


000000 


EXCH 


351 


00 00 


000000 


AOSL 


123 


00 


00 


000000 


*EXTEND 


353 


00 00 


000000 


AOSLE 


140 


00 


00 


000000 


FAD 


356 


00 00 


000000 


AOSN 


143 


00 


00 


000000 


FADB 


320 


00 00 


000000 


ARG 


141 


00 


00 


000000 


FADL 


240 


00 00 


000000 


ASH 


142 


00 


00 


000000 


FADM 


244 


00 00 


000000 


ASHC 


144 


00 


00 


000000 


FADR 


251 


00 00 


000000 


BLT 


147 


00 


00 


000000 


FADRB 


300 


00 00 


000000 


CAT 


145 


00 


00 


000000 


FADRI 


304 


00 00 


000000 


CAIA 


146 


00 


00 


000000 


FADRM 


302 


00 00 


000000 


CAIE 


170 


00 


00 


000000 


FDV 


307 


00 00 


000000 


CAIG 


173 


00 


00 


000000 


FDVB 


305 


00 00 


000000 


CAIGE 


171 


00 


00 


000000 


FDVL 


301 


00 00 


000000 


CAIL 


172 


00 


00 


000000 


FDVM 
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Table. C-1 (Gont.) 
Machine Instruction Mnemonics 



174 


00 00 


000000 


FDVR 


547 


00 


00 


000000 


HLRS 


177 


00 00 


000000 


FDVRB 


554 


00 


00 


000000 


HLRZ 


175 


00 00 


000000 


FDVRI 


555 


00 


00 


000000 


HLRZI 


176 


00 00 


000000 


FDVRM 


556 


00 


00 


000000 


HLRZM 


126 


00 00 


000000 


**FIXR 


557 


00 


00 


000000 


HLRZS 


127 


00 00 


000000 


**FLTR 


504 


00 


00 


000000 


HRL 


160 


00 00 


000000 


FMP 


534 


00 


00 


000000 


HRLE 


163 


00 00 


000000 


FMPB 


535 


00 


00 


000000 


HRLEI 


161 


00 00 


000000 


FMPL 


536 


00 


00 


000000 


HRLEM 


162 


00 00 


000000 


FMPM 


537 


00 


00 


000000 


HRLES 


164 


00 00 


000000 


FMPR 


505 


00 


00 


000000 


HRLI 


167 


00 00 


000000 


FMPRB , 


506 


00 


00 


000000 


HRLM 


165 


00 00 


000000 


FMPRI 


524 


00 


00 


000000 


HRLO 


166 


00 00 


000000 


FMPRM 


525 


00 


00 


000000 


HRLOI 


150 


00 00 


000000 


FSB 


526 


00 


00 


000000 


HRLOM 


153 


00 00 


000000 


FSBB 


527 


00 


00 


000000 


HRLOS 


151 


00 00 


000000 


FSBL 


507 


00 


00 


000000 


HRLS 


152 


00 00 


000000 


FSBM 


514 


00 


00 


000000 


HRLZ 


154 


00 00 


000000 


FSBR 


515 


00 


00 


000000 


HRLZI 


157 


00 00 


000000 


FSBRB 


516 


00 


00 


000000 


HRLZM 


155 


00 00 


000000 


FSBRI 


517 


00 


00 


000000 


HRLZS 


156 


00 00 


000000 


FSBRM 


540 


00 


00 


000000 


HRR 


132 


00 00 


000000 


FSC 


570 


00 


00 


000000 


HRRE 


500 


00 00 


000000 


HLL 


571 


00 


00 


000000 


HRREI 


530 


00 00 


000000 


HLLE 


572 


00 


00 


000000 


HRREM 


531 


00 00 


000000 


HLLEI 


573 


00 


00 


000000 


HRRES 


532 


00 00 


000000 


HLLEM 


541 


00 


00 


000000 


HRRI 


533 


00 00 


000000 


HLLES 


542 


00 


00 


000000 


HRRM 


501 


00 00 


000000 


HLLI 


560 


00 


00 


000000 


HRRO 


502 


00 00 


000000 


HLLM 


561 


00 


00 


000000 


HRROI 


520 


00 00 


000000 


HLLQ 


562 


00 


00 


000000 


HRROM 


521 


00 00 


000000 


HLLOI 


56 3 


00 


00 


000000 


HRROS 


522 


00 00 


000000 


HLLOM 


543 


00 


00 


000000 


HRRS 


523 


00 00 


000000 


HLLOS 


550 


00 


00 


000000 


HRRZ 


503 


00 00 


000000 


HLLS 


551 


00 


00 


000000 


HRRZI 


510 


00 00 


000000 


HLLZ 


552 


00 


00 


000000 


HRRZM 


511 


00 00 


000000 


HLLZI 


553 


00 


00 


000000 


HRRZS 


512 


00 00 


000000 


HLLZM 


133 


00 


00 


000000 


IBP 


513 


00 00 


000000 


HLLZS 


230 


00 


00 


000000 


IDIV 


544 


00 00 


000000 


HLR 


233 


00 


00 


000000 


IDIVB 


574 


00 00 


000000 


HLRE 


231 


00 


00 


000000 


IDIVI 


575 


00 00 


000000 


HLREI 


232 


00 


00 


000000 


IDIVM 


576 


00 00 


000000 


HLREM 


136 


00 


00 


000000 


IDPB 


577 


00 00 


000000 


HLRES 


134 


00 


00 


000000 


ILDB 


545 


00 00 


000000 


HLRI 


220 


00 


00 


000000 


IMUL 


546 


00 00 


000000 


HLRM 


223 


00 


00 


000000 


IMULB 


564 


00 00 


000000 


HLRO 


221 


00 


00 


000000 


IMULI 


565 


00 00 


000000 


HLROI 


222 


00 


00 


000000 


IMULM 


566 


00 00 


000000 


HLROM 


434 


00 


00 


000000 


lOR 


567 


00 00 


000000 


HLROS 


437 


00 


00 


000000 


lORB 
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Table C-1 (Cont.) 
Machine Instruction Mnemonics 



435 


00 


00 


000000 


lORI 


471 


00 


00 


oooooo 


ORCB I 


436 


00 


00 


000000 


lORM 


472 


00 


00 


oooooo 


ORCBM 


255 


00 


00 


000000 


JFCL 


464 


00 


00 


oooooo 


ORCM 


243 


00 


00 


000000 


JFFO 


467 


00 


00 


oooooo 


ORCMB 


267 


00 


00 


000000 


JRA 


465 


00 


00 


oooooo 


ORCM I 


254 


00 


00 


000000 


JRST 


466 


00 


00 


oooooo 


ORCMM 


266 


00 


00 


000000 


JSA 


435 


00 


00 


oooooo 


ORI 


265 


00 


00 


000000 


JSP 


436 


00 


00 


oooooo 


ORM 


264 


00 


00 


000000 


JSR 


262 


00 


00 


oooooo 


POP 


104 


00 


00 


000000 


JSYS 


263 


00 


00 


oooooo 


POPJ 


320 


00 


00 


oooooo 


JUMP 


261 


00 


00 


oooooo 


PUSH 


324 


00 


00 


000000 


JUMPA 


260 


00 


00 


oooooo 


PUSHJ 


322 


00 


00 


oooooo 


JUMPE 


241 


00 


00 


oooooo 


ROT 


327 


00 


00 


oooooo 


JUMPG 


245 


00 


00 


oooooo 


ROTC 


325 


00 


00 


oooooo 


JUMPGE 


424 


00 


00 


oooooo 


SETA 


321 


00 


00 


oooooo 


JUMPL 


427 


00 


00 


oooooo 


SETAB 


323 


00 


00 


oooooo 


JUMPLE 


425 


00 


00 


oooooo 


SETA I 


326 


00 


00 


oooooo 


JUMPN 


426 


00 


00 


oooooo 


SETAM 


135 


00 


00 


oooooo 


LDB 


450 


00 


00 


oooooo 


SETCA 


242 


00 


00 


oooooo 


LSH 


453 


00 


00 


oooooo 


SETCAB 


246 


00 


00 


oooooo 


LSHC 


451 


00 


00 


oooooo 


SETCAI 


257 


00 


00 


oooooo 


**MAP 


452 


00 


00 


oooooo 


S ETC AM 


200 


00 


00 


oooooo 


MOVE 


460 


00 


00 


oooooo 


SETCM 


201 


00 


00 


oooooo 


MOVE I 


463 


00 


00 


oooooo 


SETCMB 


202 


00 


00 


oooooo 


MOVEM 


461 


00 


00 


oooooo 


SETCMI 


203 


00 


00 


oooooo 


MOVES 


462 


00 


00 


oooooo 


SETCMM 


214 


00 


00 


oooooo 


MOVM 


414 


00 


00 


oooooo 


SETM 


215 


00 


00 


oooooo 


MOVMI 


417 


00 


00 


oooooo 


SETMB 


216 


00 


00 


oooooo 


MOVMM 


415 


00 


00 


oooooo 


SETMI 


217 


00 


00 


oooooo 


MOVMS 


416 


00 


00 


oooooo 


SETMM 


210 


00 


00 


oooooo 


MOVN 


474 


00 


00 


oooooo 


SETO 


211 


00 


00 


oooooo 


MOVNI 


477 


00 


00 


oooooo 


SETOB 


212 


00 


00 


oooooo 


MOVNM 


475 


00 


00 


oooooo 


SETOI 


213 


00 


00 


oooooo 


MOVNS 


476 


00 


00 


oooooo 


SETOM 


204 


00 


00 


oooooo 


MOVS 


400 


00 


00 


oooooo 


SETZ 


205 


00 


00 


oooooo 


MOVSI 


403 


00 


00 


oooooo 


SETZB 


206 


00 


00 


oooooo 


MOVSM 


401 


00 


00 


oooooo 


SETZI 


207 


00 


00 


oooooo 


MOVSS 


402 


00 


00 


oooooo 


SETZM 


224 


00 


00 


oooooo 


MUL 


330 


00 


00 


oooooo 


SKIP 


227 


00 


00 


oooooo 


MULB 


334 


00 


00 


oooooo 


SKI PA 


225 


00 


00 


oooooo 


MULI 


332 


00 


00 


oooooo 


SKIPE 


226 


00 


00 


oooooo 


MULM 


337 


00 


00 


oooooo 


SKIPG 


434 


00 


00 


oooooo 


OR 


335 


00 


00 


oooooo 


SKIPGE 


437 


00 


00 


oooooo 


ORB 


331 


00 


00 


oooooo 


SKIPL 


454 


00 


00 


oooooo 


ORCA 


333 


00 


00 


oooooo 


SKIPLE 


457 


00 


00 


oooooo 


ORCAB 


336 


00 


00 


oooooo 


SKIPN 


455 


00 


00 


oooooo 


ORCAI 


360 


00 


00 


oooooo 


SOJ 


456 


00 


00 


oooooo 


ORCAM 


364 


00 


00 


oooooo 


SOJA 


470 


00 


00 


oooooo 


ORCB 


362 


00 


00 


oooooo 


SOJE 


473 


00 


00 


oooooo 


ORCBB 


367 


00 


00 


oooooo 


SOJG 

— .... 
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Table C-1 (Cont.) 
Machine Instruction Mnemonics 



365 


00 





00 


000000 


SOJGE 


667 


00 00 


000000 


TLON 


361 


00 





00 


000000 


SOJL 


621 


00 00 


000000 


TLZ 


363 


00 





00 


000000 


SOJLE 


625 


00 00 


000000 


TLZA 


366 


00 





00 


000000 


SOJN 


623 


00 00 


000000 


TLZE 


370 


00 





00 


000000 


SOS 


627 


00 00 


000000 


TLZN 


374 


00 





00 


000000 


SOSA 


640 


00 00 


000000 


TRC 


372 


00 





00 


000000 


SOSE 


644 


00 00 


000000 


TRCA 


311 


00 





00 


000000 


SOSG 


642 


00 00 


000000 


TRCE 


375 


00 





00 


000000 


SOSGE 


646 


00 00 


000000 


TRCN 


371 


00 





00 


000000 


SOSL 


600 


00 00 


000000 


TRN 


373 


00 





00 


000000 


SOSLE 


604 


00 00 


000000 


TRNA 


376 


00 





00 


000000 


SOSN 


602 


00 00 


000000 


TRNE 


274 


00 





00 


000000 


SUB 


606 


00 00 


000000 


TRNN . 


277 


00 





00 


000000 


SUBB 


660 


00 00 


000000 


TRO 


275 


00 





00 


000000 


SUBI 


664 


00 00 


000000 


TROA 


276 


00 





00 


000000 


SUBM 


662 


00 00 


000000 


TROE 


650 


00 





00 


000000 


TDC 


666 


00 00 


000000 


TRON 


654 


00 





00 


000000 


TDCA 


620 


00 00 


000000 


TRZ 


652 


00 





00 


000000 


TDCE 


624 


00 00 


000000 


TRZA 


656 


00 





00 


000000 


TDCN 


622 


00 00 


000000 


TRZE 


610 


00 





00 


000000 


TON 


626 


00 00 


000000 


TRZN 


614 


00 





00 


000000 


TDNA 


651 


00 00 


000000 


TSC 


612 


00 





00 


000000 


TDNE 


655 


00 00 


000000 


TSCA 


616 


00 





00 


000000 


TDNN 


653 


00 00 


000000 


TSCE 


670 


00 





00 


000000 


TDO 


657 


00 00 


000000 


TSCN 


674 


00 





00 


000000 


TDOA 


611 


00 00 


000000 


TSN 


612 


00 





00 


000000 


TDOE 


615 


00 00 


000000 


TSNA 


676 


00 





00 


000000 


TDON 


613 


00 00 


000000 


TSNE 


630 


00 





00 


000000 


TDZ 


617 


00 00 


000000 


TSNN 


634 


00 





00 


000000 


TDZA 


671 


00 00 


000000 


TSO 


632 


00 





00 


000000 


TDZE 


675 


00 00 


000000 


TSOA 


636 


00 





00 


000000 


TDZN 


673 


00 00 


000000 


TSOE 


641 


00 





00 


000000 


TLC 


677 


00 00 


000000 


TSON 


645 


00 





00 


000000 


TLCA 


631 


00 00 


000000 


TSZ 


643 


00 





00 


000000 


TLCE 


635 


00 00 


000000 


TSZA 


647 


00 





00 


000000 


TLCN 


633 


00 00 


000000 


TSZE 


601 


00 





00 


000000 


TLN 


637 


00 00 


000000 


TSZN 


605 


00 





00 


000000 


TLNA 


130 


00 00 


000000 


UFA 


603 


00 





00 


000000 


TLNE 


256 


00 00 


000000 


XCT 


607 


00 





00 


000000 


TLNN 


430 


00 00 


000000 


XOR 


661 


00 





00 


000000 


TLO 


433 


00 00 


000000 


XORB 


665 


00 





00 


000000 


TLOA 


431 


00 00 


000000 


XORI 


663 


00 





00 


000000 


TLOE 


432 


00 00 


000000 


XORM 
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C.2 I/O INSTRUCTION AND DEVICE CODE MNEMONICS 

Table C-2 shows MACRO'S I/O instruction mnemonics and the code each 
assembles. Note that I/O machine instructions are executable only in 
executive mode. 



Table C-2 
I/O Instruction Mnemonics 



7 000 00 00 000000 


BLKI 


7 000 30 00 000000 


CONSZ 


7 000 10 00 000000 


BLKO 


7 000 04 00 000000 


DATA I 


7 000 24 00 000000 


CONI 


7 000 14 00 000000 


DATAO 


7 000 20 00 000000 


CONO 


7 000 04 00 000000 


RSW 


7 000 34 00 000000 


CONSO 







Table C-3 shows MACRO'S I/O device code mnemonics. Each is assembled 
with the I/O instruction mnemonic DATAI so that the value of the 
device code will be in its proper field. In the first table entry, 
for example, the assembled code is: 

7 024 04 00 000000 

where the 7 and 04 are generated by the DATAI instruction, and the 024 
by the ADC device code mnemonic. 



NOTE 

MACRO leaves these device code mnemonics 
as undefined symbols during Pass 1. At 
the end of Pass 1, the mnemonics are 
found in MACRO'S tables only if one or 
more I/O instructions have been found. 

Therefore, if a device code mnemonic is 
not assembled in Pass 1, or if no I/O 
instruction mnemonics were found, MACRO 
will not have defined the device code 
mnemonic. 
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Table C-3 
I/O Device Code Mnemonics 



7 


024 


04 





00 


000000 


DATA I 


ADC, 


7 


030 


04 





00 


000000 


DATA I 


ADC2, 


7 


000 


04 





00 


000000 


DATA I 


APR, 


7 


014 


04 





00 


000000 


DATA I 


CCI, 


7 


110 


04 





00 


000000 


DATA I 


CDP, 


7 


114 


04 





00 


000000 


DATA I 


CDR, 


7 


070 


04 





00 


000000 


DATA I 


CLK, 


7 


074 


04 





00 


000000 


DATA I 


CLK2, 


7 


000 


04 





00 


000000 


DATA I 


CPA, 


7 


150 


04 





00 


000000 


DATA I 


CR, 


7 


154 


04 





00 


000000 


DATA I 


CR2, 


7 


200 


04 





00 


000000 


DATA I 


DC, 


7 


204 


04 





00 


000000 


DATA I 


DC2, 


7 


300 


04 





00 


000000 


DATA I 


DCSA, 


7 


304 


04 





00 


000000 


DATA I 


DCSB, 


7 


270 


04 





00 


000000 


DATA I 


DDC, 


7 


274 


04 





00 


000000 


DATA I 


DDC2, 


7 


270 


04 





00 


000000 


DATA I 


DF, 


7 


130 


04 





00 


000000 


DATA I 


DIS, 


7 


134 


04 





00 


000000 


DATA I 


DIS2, 


7 


060 


04 





00 


000000 


DATA I 


DLB, 


7 


160 


04 





00 


000000 


DATA I 


DLB2, 


7 


064 


04 





00 


000000 


DATA I 


DLC, 


7 


164 


04 





00 


000000 


DATA I 


DLC2, 


7 


240 


04 





00 


000000 


DATA I 


DLS, 


7 


244 


04 





00 


000000 


DATA I 


DLS2, 


7 


250 


04 





00 


000000 


DATA I 


DPC, 


7 


254 


04 





00 


000000 


DATA I 


DPC2, 


7 


260 


04 





00 


000000 


DATA I 


DPC3, 


7 


264 


04 





00 


000000 


DATA I 


DPC4, 


7 


464 


04 





00 


000000 


DATA I 


DSI, 


7 


474 


04 





00 


000000 


DATA I 


DSI2, 


7 


170 


04 





00 


000000 


DATA I 


DSK, 


7 


174 


04 





00 


000000 


DATA I 


DSK2, 


7 


460 


04 





00 


000000 


DATA I 


DSS, 


7 


470 


04 





00 


000000 


DATA I 


DSS2, 


7 


320 


04 





00 


000000 


DATA I 


DTC, 


7 


330 


04 





00 


000000 


DATA I 


DTC2, 


7 


324 


04 





00 


000000 


DATA I 


DTS, 


7 


334 


04 





00 


000000 


DATA I 


DTS2, 


7 


124 


04 





00 


000000 


DATA I 


LPT, 


7 


234 


04 





00 


000000 


DATA I 


LPT2, 


7 


260 


04 





00 


000000 


DATA I 


MDF, 


7 


264 


04 





00 


000000 


DATA I 


MDF2, 


7 


220 


04 





00 


000000 


DATA I 


MTC, 


7 


230 


04 





00 


000000 


DATA I 


MTM, 


7 


224 


04 





00 


000000 


DATA I 


MTS, 


7 


010 


04 





00 


000000 


DATA I 


PAG, 



(Continued on Next Page) 
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Table C-3 (Cont.) 
I/O Device Code Mnemonics 



7 


004 


04 





00 


000000 


DATA I 


PI, 


7 


140 


04 





00 


000000 


DATA I 


PLT, 


7 


144 


04 





00 


000000 


DATA I 


PLT2, 


7 


100 


04 





00 


000000 


DATAI 


PTP, 


7 


104 


04 





00 


000000 


DATA I 


PTR, 


7 


340 


04 





00 


ooodoo 


DATAI 


TMC, 


7 


350 


04 





00 


000000 


DATAI 


TMC2, 


7 


344 


04 





00 


000000 


DATAI 


TMS, 


7 


354 


04 





00 


000000 


DATAI 


TMS2, 


7 


120 


04 





00 


000000 


DATAI 


TTY, 


7 


210 


04 





00 


000000 


DATAI 


UTC, 


7 


214 


04 





00 


000000 


DATAI 


UTS, 



C-8 



MACRO-DEFINED MNEMONICS 



C.3 KLIO EXTEND INSTRUCTION MNEMONICS 

Table C-4 shows the KLIO EXTEND instruction mnemonics and the code 
assembled by each. All of these mnemonics are defined only if MACRO 
is assembled with the KLIO switch on. 

See the Supplement to the Hardware Reference Manual for a discussion 
of these EXTEND instructions. 



Table C-4 
KLIO EXTEND Instruction Mnemonics 



002 00 00 000000 


*CMPSE 


010 00 00 000000 


*CVTDBO 


007 00 00 000000 


*CMPSG 


Oil 00 00 000000 


*CVTDBT 


005 00 00 000000 


*CMPSGE 


004 00 00 000000 


*EDIT 


001 00 00 000000 


*CMPSL 


016 00 00 000000 


*MOVSLJ 


003 00 00 000000 


*CMPSLE 


014 00 00 000000 


*MOVSO 


006 00 00 000000 


*CMPSN 


017 00 00 000000 


*MOVSRJ 


012 00 00 000000 


*CVTBDO 


015 00 00 000000 


*MOVST 


013 00 00 000000 


*CVTBDT 


020 00 00 000000 


*XBLT 
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C.4 JRST AND JFCL MNEMONICS 

Table C-5 shows mnemonics that assemble both operator and accumulator 
fields in the machine instruction. The left side of the- table shows 
the mnemonics and the code they generate; the right side shows JRST 
and JFCL mnemonics with accumulators generating the equivalent code. 



Table C-5 
JRST and JFCL Mnemonics 



Code and 


Mnemonic 




EqU] 


Lvalent Code and 


Mnemonic 


254 


04 


00 


000000 


HALT 


254 


04 


00 


000000 


JRST 4, 


255 


06 


00 


000000 


JCRY 


255 


06 


00 


000000 


JFCL 6, 


255 


04 


00 


000000 


JCRYO 


255 


04 


00 


000000 


JFCL 4, 


255 


02 


00 


000000 


JCRYl 


255 


02 


00 


000000 


JFCL 2, 


254 


12 


00 


000000 


JEN 


254 


12 


00 


000000 


JRST 12, 


255 


01, 


00 


000000 


JFOV 


255 


01 


00 


000000 


JFCL 1> 


255 


10 


00 


000000 


JOV 


255 


10 


00 


000000 


JFCL 10, 


254 


02 


00 


000000 


JRSTF 


254 


02 


00 


000000 


JRST 2, 


254 


01 


00 


000000 


PORTAL 


254 


01 


00 


000000 


JRST 1, 


254 


06 


00 


000000 


*XJEN 


254 


06 


00 


000000 


JRST 6, 


254 


05 


00 


000000 


*XJRSTF 


254 


05 


00 


000000 


JRST 5, 


254 


07 


00 


000000 


*XPCW 


254 


07 


00 


000000 


JRST 7, 


254 


14 


00 


000000 


*XSFM 


254 


14 


00 


000000 


JRST 14, 
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APPENDIX D 
PROGRAM EXAMPLES 



The following pages contain examples of MACRO programs. Each program 
has been assembled with the /C (CREF) switch on; this produces a .CRF 
file for the program listing (instead of the usual .LST file) . The /O 
switch has been used with the CREF program to produce a .LST file that 
includes all operators in an operator symbol table. 
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O 
I 



3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 

NO ERRORS DETECTED 

PROGRAM BREAK IS 000000 
CPU TIME USED 00 t 00. 570 

34P CORE USED 



SUBTTL Example One 
UNIVERSAL MACROS 

JThis UNIVERSAL program contains the macro QUITr which uses 

r conditional assembly to Generate a program exit monitor 

; call* If the TOPSIO switch is on when QUIT is called (or if 

f it is undefined) f QUIT sienerates "EXIT"? if the switch 

; is offf QUIT Generates "HALTF"* 

DEFINE QUIT < 

IFNDEF TOPSIO r< 
T0PS10==-1 

IFE TOPSIO »< 
HALTF 

I FN TOPSIO F< 
EXIT 



PRGEND 



ffDefault is TOPSIO 



h3 

O 

O 



a 

X 

> 
s: 

f 
w 
en 
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O 
I 

U) 



23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 



SUBTTL Example Two 

TITLE Second Example of MACRO Program 

This program contains the macros CLEARr CONCATu and EXPAND* 
These can be used to append arbitrary text into a buffer r 
and to recall the text later. Two seauences of calls 
to the macros show possible uses. 

The following points are of interest: 

1. The buffer is cleared by calling CLEAR. Text is added 
(on the riaht side of the buffer) by callinsi CONCAT. 
EXPAND » when used in a context allowed for macro callsf 
expands the contents of the buffer into source code. 

2. A call to CLEAR defines the text buffers EXPAND^ to 
contain no text. It also defines the macro CONCAT in 
such a way that the first call to CONCAT redefines 
EXPAND to contain the first piece of text» and CONCAT 
redefines itself so that further calls to CONCAT will 
call the internal macro CONl. Following the second 
call to CONCATr each further call merely appends new 
text to the old. 

3. A key feature of EXPAND is that it contains no carriaae 
returns. If it did* then each concatenation of new 
text would also insert a carriage return into the text. 

4. The first use of these macros shows that EXPAND can be 
placed in contexts where more than one arsfument will 
result (as in the BYTE Pseudo-op). Note that because 
anslle brackets are used internally (inside the macros) 
to delimit text» all concatenated text must contain 
matched an^le brackets. 

5. Note that carria^ae returns^ if desiredr can be easily 
concatenated to the buffer? this is done in the second 
use of the macros. 



O 

a 



w 

> 
s: 
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a 
I 



62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 



000000' 010 101 006 00000 



DEFINE CLEAR < 

DEFINE CONCAT (FTXT) < 
DEFINE CONCAT (TEXT) •= 
CONl <TEXT>f<FTXT> 

DEFINE EXPAND <FTXT> 

DEFINE EXPAND <> 



DEFINE CONl (NTXT»OTXT) < 
DEFINE CONCAT (TEXT) < 

CONl <TEXT::-»<0TXT'NTXT> 

DEFINE EXPAND <OTXT'NTXT> 



SALL 

CLEAR 

CONCAT <10> 

CONCAT <f> 

CONCAT <"A"> 

CONCAT <r«-lrt6>&177» 

LALL 

BYTE (7)EXPAND"10»'A'»«-l»f6>8177>' 

SALL 
CLEAR 

CONCAT <DEF> 

CONCAT <INE FOO (> 

CONCAT <N» 

CONCAT «2*N> 

DEFINE> 

CONCAT < BAR (N) <3*N> 



« * * 



O 
O 



w 
> 

CO 
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105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 



000001' 000000 000004 

000002' 000000 000006 

000003' 000000 000006 

000004' 000000 000011 



LALL 

EXPAND'TiEFINE FOO <N)<2*N> 

DEFINE BAR <N) <3*N> 



FOO 2"2*2' 

FOO 3"2*3' 

BAR 2'"3*2' 

BAR 3''3*3' 



PRGEND 



NO ERRORS DETECTED 



O 
I 



PROGRAM BREAK IS 000005 
CPU TIME USED 00 : 00. 166 

34P CORE USED 



O 

a 



> 
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D 
I 



118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 



SUBTTL Example Three 

TITLE Third Example of MACRO Program 

This program uses the macros NUMLST and X to Generate parallel 
tables* 

This example Generates a table that contains keywords suitable 
for comparison to user input? the second table Generated 
contains addresses of routines that handle those keywords? 
the third table contains useful values. 

The keyword table is arranged alphabetically to speed searching? 
the other two tables correspond entry-for-entry to the 
keyword table* 

Key features of this prosiram include* 

1* Chan^ina the size of the tables is easy* For example^ 
if a new entryr FIFTHr is needed* addinsE the word and 
a dummy label to the definition of NUMLST will update 
both tables? no separate update is reauired* 

2. The macro NUMLST calls the macro X. Before each call 
to NUMLSTf X is redefined so that the proper kind of 
table is built* Note that a definition of X need not 
use both arguments in the macrobody* (However* X should 
define both arsfuments*) 

3* The second definition of X uses concatenation to build 
mnemonic labels for the table LBLTBL* 

4, The program uses the macro QUIT so that it can be used 

for either TOPS-10 or TOPS-20* The SEARCH MACROS statement 
makes the definition of QUIT available? since the default 
for QUIT is T0PS-10» the program will run on TOPS-10 if 
either it defines T0PS10=-1 or does not define TOPSIO? 
the program will run on TOPS-20 only if it defines 
T0PS10=0* 



ha 
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O 



a 
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> 
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158 










159 










160 










161 






000000 




162 










163 










164 










165 










166 










167 










168 










169 










170 










171 










172 










173 


000000' 








174 


000000' 


465162 


636400 




175 


000001' 


465765 


626450 




176 


000002' 


634543 


575644 




177 


000003' 


645051 


624400 


D 

1 


178 
179 






000004 


-J 


180 
181 
182 


000004' 








183 


000004' 


000000 


000014' 




184 


000005' 


000000 


000017' 




185 


000006' 


000000 


000015' 




186 


000007' 


000000 


000016' 




187 










188 










189 










190 


000010' 








191 


000010' 


000000 


000001 




192 


000011' 


000000 


000004 




193 


000012' 


000000 


000002 




194 


000013' 


000000 


000003 




195 










196 









SEARCH MACROS rMONSYM 
T0PS10==0 
♦DIRECTIVE SECOND 

DEFINE NUMLST < 
X (FIRSTfl) 
X <F0URTHf4) 
X (SEC0ND»2) 
X <THIRDf3) 



DEFINE X (TEXT, JUNK) <EXP SIXBIT /TEXT/!: 

NAMTBL: NUMLST-" 

X (FIRSTrl)"EXP SIXBIT /FIRST/-" 
X (FOURTH, 4) -"EXP SIXBIT /FOURTH/-" 
X (SEC0NDf2)'"EXP SIXBIT /SECOND/-" 
X (THIRD, 3) -"EXP SIXBIT /THIRD/'* 

TBLLEN==. -NAMTBL 

DEFINE X (JUNKfLABL) <*'LABL> 

LBLTBL: NUMLST-" 

X (FIRST, 1)-"$1-" 
X (FOURTH, 4) -$4" 
X (SECOND, 2) -"$2-" 
X (THIRD,3)'"*3-"' 

define x (junk,valu) <dec valu> 

valtbl: numlst- 

x (first, 1)-"dec 1-" 
x (fourth, 4) -"dec 4" 
x (second, 2) "dec 2-" 
x (third, 3)'"dec 3" 



O 
O 
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197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 



000014' 

000014' 104 00 00 000170 

000015' 

000015' 104 00 00 000170 

000016' 

000016' 104 00 00 000170 

000017' 

000017' 104 00 00 000170 



XALL 




*i: 


QUIT" 




HALTF 


*2: 


QUIT" 




HALTF 


*3: 


QUIT" 




HALTF 


$4? 


QUIT" 




HALTF 


PRGEND 





NO ERRORS DETECTED 



a 

I 

00 



PROGRAM BREAK IS 000020 
CPU TIME USED 00:00.152 

34P CORE USED 



W 
O 

o 
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X 

> 
s: 
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HALTF 



104000 000170 int 



LBLTBL 


000004' 


NAMTBL 


000000' 


TBLLEN 


000004 SPd 


TOPSIO 


000000 spd 


VALTBL 


000010' 


$1 


000014' 


*2 


000015' 


*3 


000016' 


$4 


000017' 



D 
I 
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210 
211 
212 
213 
214 
215 
216 
217 
218 
217 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 



SUBTTL Example Four 

TITLE Fourth Example of MACRO Program 

This prodram contains a complex and useful macror COMMON. 
The macro allows declaration of variable names for a 
FORTRAN-compatible COMMON block. Note that the pseudo-op 
♦COMMON allows declaration of a COMMON block* but not of 
variable names within the block. 

The COMMON macro uses two arsluments. 

1. The name of the COMMON block. 

2. An IRP-style list of the variable names for the block. 
The list can contain either variable names onla (with 
an assumed length of one word for each variable) » or 
can contain an anale-bracketed pair divina the name and 
the length in decimal. 

Key features of the program include! 

1. Lengths for variables are aiven in decimal numbers* 
so that the definitions look much like those in the 
FORTRAN landuade. This is accomplished by storing 
the current radix in a created symbol* and restoring 
it at the end of the macro. 

2. The macro uses the techniaue of IRPina more than once 
on the IRP list. The first IRP counts the length of 
the entire COMMON block* so that the .COMMON Pseudo-OP 
can be used* the second IRP declares variable names 
for each entry in the block. 

3. The pseudo-ops .XCREF and PURGE are used often 

in the macro* this is to remove references to created 
symbols from the CREF listind and the symbol table. 

4. Created symbols are used in the macro for symbols that 
are used only within the macro itself. This minimizes 
the chance that other definitions will conflict with 
these symbols* 

5. Once the COMMON macro has been called* symbols in the 
COMMON block may be used much as any other symbols* 
this is shown in the IFIX and ZERO routines. 



O 
(D 

> 

ra 
> 

ra 

CO 



Fourth Examr-le of MACRO Proarsm MACRO ZSZdOl?) 16 J 17 2-M3r-78 Pa^e 9 
EXAM20 MAC 2-M3r~78 16117 EKample Four 



257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 



DEFINE COMMON (COMf VARSr%RAD»%LENf %VALf %COMf ZPAS) < 
♦ XCREF %RAD » /CLEN r ZVAL r XCOM r %PAS 

JrTeiTiP macro to strip one pair of an^le brackets from 
if 3 macro argument and pass it to another macro 

DEFINE XPAS (ArB) <A B> 

TTTemp macro to compute length of COMMON 

DEFINE ZCOM <VARrLEN<l>) <%LEN==%LEN+LEN> 



%RAD==10 

RADIX 10 

%LEN==0 

IRP VARS<%PAS ZCOM»VARS> 

♦COMMON C0MC%LEN3 

DEFINE %COM (VAR»LEN<1>) 
UAR=%UAL 
%VAL==%VAL+LEN 



%LEN==0 

%VAL==COM 

IRP VARS<ZPAS %COMfVARS> 

RADIX %RAD 



rSave current radixi» use 10 
; so defs read like FORTRAN 
»Set to count lenath of COMMQN 
JGet length of this COMMON 
^Allocate the whole COMMON 

>Set UP another temp macro 
; Define COMMON block entry 
J Increment to next entry 



» ^Reinitialize lendth 
JJStart to define entries in block 
J f Define next COMMON entry 
JJRestore current radix 



IF2f<PURGE %LEN»%RAD»ZVAL»%COM»%PAS> fJKeep symbol table clean 



h3 
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a 

I 



291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 



000000' 122 01 00 000000* 
000001' 202 01 00 000000* 
000002' 263 17 00 000000 



000003' 200 01 00 000007' 

000004' 402 00 00 000000* 

000005' 251 01 00 000000* 

000006' 263 17 00 000000 



000007' 
000007' 



000000* 000000* 



i INTEGER SNGLE» ARRAY fMULTI 

i REAL REAL 

f DOUBLE PRECISION DOUBLE 

f COMMON /AREA/SNGLErREALrD0UBLErARRAY(10)fMULTI<5rl0) 

COMMON AREA r <SNGLE f REAL » <DOUBLE» 2> f <ARRAY 1 10> f <MULTI » 5*10»" 

fSample routine to do SNGLE=IFIX(REAL) 

IFIX: FIX 1»REAL 

MOVEM 1»SNGLE 
POP J 17 r 

» Sample routine to set all elements in ARRAY to 

zero: move 1»CXUD ARRAY»ARRAY+1D 
SETZM ARRAY 
BLT lfARRAY+''D9 
POPJ 17t 

LIT 



END 



NO ERRORS DETECTED 
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PROGRAM BREAK IS 000010 
CPU TIME USED 00:00.232 



36P CORE USED 
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AREA 


000001' 


e;;t 


ARRAY 


000000000000* 


POl 


DOUBLE 


000000000000* 


POl 


IFIX 


000000' 




MULTI 


000000000000* 


pol 


REAL 


000000000000* 


POl 


SNGLE 


000000* 




ZERO 


000003' 
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AREA 


299* 


299 


ARRAY 


299* 


308 


DOUBLE 


299* 




IFIX 


302* 




LBLTBL 


182* 




MULTI 


299* 




NAMTBL 


173* 


178 


REAL 


299* 


302 


SNGLE 


299* 


303 


TBLLEN 


178* 




TOPSIO 


161* 


201 


VALTBL 


190* 




ZERO 


308* 




*1 


183 


200* 


$2 


185 


202* 


$3 


186 


204* 


$4 


184 


206* 



309 310 



202 203 204 205 206 207 208 



O 
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CO 



BAR 


109# 


114 


115 












CLEAR 


64* 


83 


94 












COMMON 


259* 


298 














CONl 


74* 


86 


87 


88 


97 


98 


100 


102 


CONCAT 


83* 


85 


85* 


86 


86* 


87 


87* 


88 




98 


98* 


99 


100* 


101 


102* 






EXPAND 


83* 


85* 


86* 


87* 


88* 


91 


94* 


96 


FOO 


108* 


112 


113 












HALTF 


201 


203 


205 


207 










NUMLST 


164* 


173 


182 


190 










QUIT 


10* 


200 


202 


204 


206 








X 


171* 
194 


174 


175 


176 


177 


180* 


183 


184 


..0004 


299 


299* 














..0005 


299 
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97* 98* 100* 102* 108 

185 186 188* 191 192 193 
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BLT 


310 








BYTE 


91 








DEC 


191 


192 


193 


194 


DEFINE 


10 


64 


74 


83 




108 


109 


164 


171 


END 


316 








EXP 


174 


175 


176 


177 


FIX 


302 








IF2 


299 








IFE 


201 


203 


205 


207 


I FN 


202 


204 


206 


208 


IFNDEF 


201 


203 


205 


207 


IRP 


299 








LALL 


90 


107 






LIT 


313 








MOVE 


308 








MOVEM 


303 








POPJ 


304 


311 






PRGEND 


21 


117 


209 




PURGE 


299 








RADIX 


299 








SALL 


81 


93 






SEARCH 


160 








SETZM 


309 








SIXBIT 


174 


175 


176 


177 


SUBTTL 


1 


22 


118 


210 


TITLE 


23 


119 


211 




UNIVER 


2 








XALL 


199 








XUD 


308 








.COMMO 


299 








.DIREC 


162 
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APPENDIX E 
PSEUDO-OPS FOR SYSTEM COMPATIBILITY 



The pseudo-ops in this appendix are included for system compatibility; 
they are to be used only to assemble TOPS-10 programs while running 
TOPS-20. 
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PSEUDO-OPS FOR SYSTEM COMPATIBILITY 



HISEG 



FORMAT HISEG address 

address = program high-segment origin address. Must be 
equal to or greater than 400000 and must be a 
multiple of 1000. 

FUNCTION Directs the loader to load the current program into the 
high segment if the program has reentrant (two-segment) 
capability. HISEG should appear at the beginning of 
the source program. 

HISEG does not affect assembler operation. The code 
produced by HISEG will execute at either relocatable 
or relocatable 400000, depending on the loading 
instructions given. 

The code following HISEG looks as if it was assembled 
to start at relocatable 0. 

This pseudo-op has been replaced by TWOSEG. 
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PSEUDO-OPS FOR SYSTEM COMPATIBILITY 




FORMAT 



RIM 



FUNCTION 



Specifies a format for absolute binary programs (useful 
only for PDP-6 systems) , and consists of a series of 
paired words. 



The first word of each pair is a paper-tape read 
instruction giving the memory address of the second 
word. The last pair of words is a transfer block; the 
first is an instruction obtained from the END statement 
and executed when the transfer block is read, and the 
second is a dummy word to stop the reader. 
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PSEUDO-OPS FOR SYSTEM COMPATIBILITY 



RIMIO 



FORMAT 
FUNCTION 



RIMIO 



Causes a program format in which programs are absolute, 
unblocked, and not checksummed. When the RIMIO 
statement follows a LOC statement in a program, the 
assembler punches out each storage word in the object 
program, starting at the absolute address specified in 
the LOC statement. RIMIO writes an arbitary "paper 
tape"; if it is in the format given below, it can be 
read by the DECsystem-10 Read-In Mode hardware. 

lOWD n, first 

where n is the length of the program including the 
ending word transfer, and first is the first memory 
location to be occupied. The last location must 
contain a transfer instruction to begin the program, 
such as 

JRST 4rG0 

For example, if a program with RIMIO output has its 
first location at START and its last location at 
FINISH, you can write 

lOWD FINISH-START+lrSTART 



NOTE 

If the location counter is increased but no 
binary output occurs (for example, BLOCK, LOC, 
and VAR pseudo-ops) , MACRO inserts a zero word 
into the binary output file for each location 
skipped by the location counter. 
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PSEUDO-OPS FOR SYSTEM COMPATIBILITY 



RIMIOB 



FORMAT 



RIMIOB 



FUNCTION 



If a program is assembled into absolute locations (not 
relocatable) , a RIMIOB statement following the LOC 
statement at the beginning of the source program causes 
the assembler to write out the object program in RIMIOB 
format. This format is designed for use with the 
DECsystem-lO Read-In Mode hardware. 

The program is punched during Pass 2, starting at the 
location specified in the LOC statement. If the first 
two statements in the program are 

LOC 1000 
RIMIOB 

MACRO assembles the program with absolute addresses 
starting at 1000 and punches the program in RIMIOB 
format, also starting at location 1000. You can reset 
the location counter during assembly, but only one 
RIMIOB statement is needed to punch the entire program. 

In RIMIOB format, the assembler punches the RIMIOB 
Loader, followed by the program in 17-word (or less) 
data blocks, each block separated by blank tape. The 
assembler inserts an I/O transfer word (lOWD) preceding 
each data block, and also inserts a 36-bit checksum 
following each data block. The word count in the lOWD 
counts only the data words in the block, and the 
checksum is the 36-bit added checksum of the lOWD and 
the data words. 



Data blocks can contain less than 17 words. 



If the 



assembler assigns a nonconsecutive location, the 
current data block is terminated, and an lOWD 
containing the next location is inserted, starting a 
new data block. 

The transfer block consists of two words. The first 
word of the transfer block is an instruction obtained 
from the END statement. This first word is executed 
when the transfer block is read. The second word is a 
dummy word to stop the reader. 
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APPENDIX F 
STORAGE ALLOCATION 



MACRO allocates storage in two directions: 

1. User symbols and macronames are entered in the symbol tables. 

2. Macros and literals are entered in free space. 

A symbol table entry is two words long. The first word is the symbol 
name in SIXBIT. The second word has flags in the left half, and 
either the value or a pointer in the right half. The flags indicate 
symbol type and attributes. 

The following list shows how symbols and values are stored. 



Type 

18-bit symbol 

36-bit symbol 

(includes OPDEFs 

and negative numbers) 

EXTERNAL symbol 



Polish symbol 



How Stored 

Value in right half of second word. 

Value in free storage with a pointer in 
symbol table. 



Pointer in symbol table to a 2-word block in 
free storage. The first word is the value 
that is the last reference in a chain of 
references to the symbol; the second word is 
the symbol name in SIXBIT. 

The symbol table entry points to a 2-word 
block: 

word 1: 

word 2: negative number ,, address 

Word 1 is the relocation word and is always 
zero. Word 2 gives the address of a Polish 
stack in free storage. The Polish stack is 
of the form: 



word 1 

word 2 

word 3 

word 4 

word 5 

word 6 





opcode 

relocation constant 

value 

relocation constant 

value 
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STORAGE ALLOCATION 



Words 3 and 4 designate an operand. If the 
operator is binary, words 5 and 6 designate 
the second operand; if the operator is 
unary, the stack contains only four words. 

If an operand is EXTERNAL, its two words (3 
and 4, or 5 and 6) are: 

word i: pointer to EXTERNAL symbol 
word i+1: 



If an operand is itself a Polish symbol, 
two words are: 



its 



word i: Polish pointer 
word i+1: 



Inter-PSECT reference Polish stack containing: 



word 
word 
word 
word 
word 
word 




15 
-2 

referenced PSECT index 
relocation constant 
address 



Synonym operator 
(SYN argument) 

Macroname 



SIXBIT operator name in free storage witha 
pointer in the symbol table. 

Value in free storage with a pointer to the 
text string in symbol table. 

The text string is stored in a 4-word block 
of the form: 



word 1: 

word 2 

word 3 

word 4 



link to next block (0 
last),, two characters 
five characters 
five characters 
five characters 



if 



However, the first such block is 
special: 

word 1: link to next block,, link 
to last block 

word 2: pointer to default 
arg.,, number of args 
expected + reference count 

word 3: five characters 

word 4: five characters 

The number of args expected is the number of 
dummy-arguments in the macro definition. 

The reference count is incremented when the 
macro is called and decremented when the 
macro is exited. When this count goes to 
zero, the macro is removed from free space. 
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STORAGE ALLOCATION 

Macro arguments Stored in the same linked block, but not in 

the symbol table. Repeats (two or more 
times) are also stored in the same way. The 
text blocks are removed when the macro exits 
or the repeat exits, since the reference 
count has gone to zero. 

The addresses of the actual argument blocks 
are stored in a pushdown stack in order of 
generation. 

Default arguments are stored in the same way, 
except that the list is in free core. The 
pointer to the default arg list is stored in 
the left half of the second word of the first 
block of the macro definition. 

Macros The macrobody is stored as is, except that 

dummy-arguments are replaced by special 
symbols. 

ASCII 177 (RUBOUT) signals that the next 
character is a special character, as follows: 

001 . ;end of macro 

002 ;end of dummy symbol 

003 ;end of REPEAT 

004 ;end of IRP or IRPC 

005 ; RUBOUT 

If the character is more than 5 and less than 
100, it is illegal. 

If the character is greater than or equal to 
100, it is a dummy symbol; the value of the 
character is ANDed with 37 to get the dummy 
symbol number, and the corresponding pointer 
retrieved from the stack of actual arguments. 

If the symbol was not specified (that is, has 
no pointer), and if the 40 bit is on, this 
symbol requires a created symbol, and one is 
created; otherwise the argument is ignored. 

NOTE 

Verbose macros can use too much 
storage space. 
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Literals 



STORAGE ALLOCATION 



Four-word block for each word generated 



word 1 
word 2 
word 3 
word 4 



form word 

relocation bits 

code 

pointer to next block 



Form word is the word used for listing. 
This word is not checked when comparing 
literals, so that different forms 
producing the same code are classed as 
equal . 

Relocation bits are 0, 1, or EXTERNAL 
pointers. 

Pointer is the address of the zero word 
of the next block. 



NOTE 

Long literals slow assembly and 
use storage; they should be 
written as subroutines or inline 
code. 
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APPENDIX G 
ACCESSING ANOTHER USER'S FILE 



MACRO allows you to access another user's file in two ways. The first 
is to give a logical name in place of the device name; the second is 
to give a project-programmer number instead of a directory name. You 
can give either of these in your program or in a MACRO command line. 

For more information about referencing other users' files, refer to 
the DECSYSTEM-20 User's Guide. 



G.l USING LOGICAL NAMES 

To use a logical name in accessing another user's file, you must: 

1. Give the DEFINE command to define a logical name (of no more 
than six characters) as the other user's directory name. 

2. Use the logical name as the device name whenever giving the 
file specification. 



G.1.1 Giving the DEFINE Command 
To give the DEFINE command: 

1. Type DEF and press the ESCAPE key; the system prints INE 
(LOGICAL NAME) . 

©DEFINE (LOGICAL NAME) 

2. Type the logical name, ending it with a colon; then type the 
directory name in angle brackets and RETURN: 

©DEFINE (LOGICAL NAME) BAK:<BAKER> 

e 

To check the logical name, give the INFORMATION (ABOUT) 
LOGICAL-NAMES command. 

eiNFORMATION (ABOUT) LOGICAL-NAMES 

BAK : => <BAKER> 
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ACCESSING ANOTHER USER'S FILE 

G.1.2 Using the Logical Name 

You can include the logical name in a command line or in your program, 



G. 1.2.1 Command Lines - To include the logical name in a command 
line, type the logical name in place of a device name. 

The following example shows how to compile the file <BAKER>SPEC.MAC, 
You must have already defined the logical name BAK: as <BAKER>.) 

©MACRO 

♦SPEC ♦ REL=BAK : SPEC . MAC 



G.1.2, 2 User Programs - After giving the DEFINE command, include the 
logical name within the program to reference the file. 

The following example shows how to reference the file 
<BAKER>MACROS.MAC with a .REQUEST pseudo-op. 

♦REQUEST BAK:MACR0S«MAC 

This command causes LINK to load the file MACROS. MAC from the 
directory that has been assigned the logical name BAK. 



G.2 USING PROJECT-PROGRAMMER NUMBERS 

To use a project-programmer number in accessing another user's file, 
you must: 

1. Run the TRANSL program to find the corresponding 
project-programmer number for the given directory name. 

2. Include the project-programmer number after the filename. 

You do not have to define a logical name if you . use a 
project-programmer, number. Project-programmer numbers, however, 
sometimes change; therefore, use logical names wherever possible. 



G.2.1 Running the TRANSL Program 
To run the TRANSL program, you must: 

1. Type TRANSL and press the ESCAPE key. The system completes 
the line as TRANSLATE (DIRECTORY). 

©TRANSLATE (DIRECTORY) 

2. Type the directory name and press the RETURN key. The system 
prints the appropriate project-programmer number. 

TRANSLATE (DIRECTORY)<BAKER> 
PS:<BAKER> IS PS:C4y2043 
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You can also use the TRANSL program to make sure a project-programmer 
number is correct. Simply replace the directory name with the 
project-programmer number. 

eTRANSLATE (DIRECT0RY)C4»204D 
PS:C4»2043 IS PS:<BAKER> 



G.2.2 Using the Project-Programmer Number 

You can include the project-programmer number in a command line or in 
your program. Because project-programmer numbers can change, you 
should use a logical name. 



G.2.2.1 Command Lines - To include a project-programmer number in a 
command line, type the project-programmer number after the file 
specification. 

The following example shows how to compile the file <BAKER>SPEC.MAC by 
using a project-programmer number. 

©MACRO 

*SPEC ♦ REL=SPEC ♦ MACC4 » 2043 



G.2.2. 2 User Programs - After obtaining the project-programmer 

number, you can use it within the program to reference the file. 

The following example shows how to reference the file 
<BAKER>MACROS.MAC from your program. 

♦REQUEST MACROS. MACC4r2043 

This command causes LINK to load the file MACROS. MAC from the 
directory associated with [4,204]. 
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/A, 7-3 

Absolute address, 3-38, 

3-46 
Absolute expression, 2-15 
Absolute symbol, 2-12 
Accumulator, 4-4 
Accumulator, 

implicit, 4-6 
Addition, 2-13 
Address, 1-3, 4-4 
Address, 

absolute, 3-38, 3-46 

relocatable, 3-46, 3-57 

starting , 3-17 
Address assignment, 4-3 
Allocation, 

storage, F-1 
Ampersand (&) , B-4 
AND, 2-13 

Angle brackets (<>) , B-7 
Apostrophe ('), 6-2, B-5 
Argument, 

concatenating, 5-8 

default, 5-8 

dummy, 5-1, 5-2 

missing, 5-2 
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passed, 5-1, 5-^2 
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5-4 
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Argument list, 5-4 
Argument storage, 

macro, F-3 
Arithmetic expression, 2-13 
Arithmetic operator, 2-13 
Arithmetic overflow, 3-16 
ARRAY, 3-2 
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ASCII character codes, A-1 
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ASCIZ, 3-4 

Assembler output, 6-1 
Assembly, 
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.ASSIGN, 3-6 
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ASUPPRESS, 3-7 
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angle, B-7 
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BYTE, 3-9 
Byte pointer, 3-50 
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Call, 

macro, 5-2 
Character codes, A-1 
Characters, 

ASCII, 2-1 

MACRO, 2-1 

special, 2-2 
Code, 

error, 6-3 

relocatable, 1-3 
Codes, 

symbol table, 6-4 
Colon, B-3 
Colon (:) , B-7 
Colon ( : :) , 

double, B-3 
Comma (,), B-4 
Comma ( , , ) , 

double, B-4 
Command level, 

MACRO, 7-1 
Comment, 3-10, 3-59, 4-2, 

4-3 
COMMENT (pseudo-op) , 3-10 
Comment pseudo-ops, 

COMMENT, 3-10 

REMARK, 3-59 
.COMMON, 3-11 
Compatibility pseudo-ops, 

E-1 
Compilation, 

program, 7-1 
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MACRO, 7-3 
Complement, 

one's, 2-14 

two's, 2-2 
Concatenating argument, 5-8 
Conditional assembly, 3-23, 

3-24, 3-25, 9-5 
Conditional pseudo-ops, 

.IF, 3-23 

.IFN, 3-24 

IFx group, 3-25 
Counter, 

location, 2-8, 3-15, 3-38, 
3-46, 3-49, 3-57, 3-74, 
4-4, B-3 
Counter pseudo-ops, 

.ENDPS, 3-18 

LOC, 3-38 

.ORG, 3-46 

.PSECT, 3-53 

RELOC, 3-57 

TWOSEG, 3-74 
Created symbol, 5-9 
.CREF, 3-12 
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3-79, 6-4 
CTRL/underscore, B-6 
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floating-point, 2-4 
Decimal point (.), B-3 
Default argument, 5-8 
DEFINE (pseudo-op) , 3-14 
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label, 2-10 

macro, 5-1 
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symbol, 2-10, 3-70, 4-3 
DEPHASE, 3-15 
Device code, 4-6 
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I/O, C-6 
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.DIRECTIVE, 3-16 
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4-4, B-3 
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Dummy-argument, 5-1, 5-2 
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/E, 7-3 
END, 3-17 
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Ent code, 6-4 
ENTRY, 2-12, 3-19 
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double, B-7 
.EROVL, 3-16 
Error code, 6-3 

single-character, 8-3 
Error messages, 

MCRxxx, 8-7 
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2-14, 2-15 
Examples, 

program, D-1 
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B-4 
EXP, 3-20 
Expression, 

absolute, 2-15 

arithmetic, 2-13 

evaluating, 2-15 

logical, 2-13 

nested, 2-15 

Polish, 2-14 . 

relocatable, 2-15 
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evaluating, 2-14 
Ext code, 6-4 
EXTEND, 4-7 
EXTEND mnemonics, 

KLIO, C-9 
Extended Instruction, 

KL-10, 4-7 
EXTERN, 2-13, 3-21 
EXTERNAL symbol, 2-12, 2-13, 

2-14 
EXTERNAL symbol storage, 
F-1 
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File, 

listing, 6-1 

UNIVERSAL, 6-5, 9-4 
Fixed-point decimal number, 
2-3 
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IRPC, 3-31, 5-10 
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G, 2-3, B-2 

/G, 7-3 

Global symbol, 2-12, 2-13 



/H, 7-3 

Halfword, 1-3, 3-82 
Halfword notation, 2-15 
Hierarchy of operations, 

2-14 
HISEG, E-2 
.HWFRMT, 3-21 
Hyphen (-) , B-4 
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I/O, 4-6 

primary, 4-4 
Int code, 6-4 
Integer, 2-2, 3-55 
INTEGER (pseudo-op) , 3-27 
inter-PSECT reference 

storage, F-2 
INTERN, 2-12, 3-28 
INTERNAL symbol, 2-12 
Interpretation, 

argument, 5-11 
lOWD, 3-29 
IRP, 3-30, 5-10 
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JRST mnemonics, C-10 



K, 2-3, B-2 
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KIIO, 3-16 

KL-10 Extended Instruction, 

4-7 
KLIO, 3-16 
KLIO EXTEND mnemonics, C-9 
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'^L, B-2 

Label, 4-1, 4-3 
Label definition, 2- 
Label in literal, 2- 
Label symbol, 2-10 
LALL, 3-32 
.LINK, 3-33 
Linkage pseudo-ops, 
.COMMON, 3-11 
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DEPHASE, 3-15 
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.DIRECT KLIO, 3-1 
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LIT, 3-35 
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Repeat, 

indefinite, 3-30, 3-31, 

3-67, 5-10 
REPEAT (pseudo-op) , 3-60 
.REQUEST, 3-61 
.REQUIRE, 3-62 
RIM, E-3 
RIMIO, E-4 
RIMIOB, E-5 
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ENTRY, 2-12, 3-19 

EXTERN, 2-13, 3-21 
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Variable symbol, 2-11, 3-77 



Z, 3-83 



Index- 7 



MACRO ASSEMBLER 
Reference Manual 
AA-4159C-TM 



READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 

Did you find errors in this manual? If so/ specify by page. 



c 
o 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 



Please indicate the type of user /reader that you most nearly represent. 

I I Assembly language programmer 

(~1 Higher-level language programmer 

I I Occasional programmer (experienced) 

Q User with little programming experience 

^ Q Student programmer 

I ) Non-programmer interested in computer concepts and capabilities 

Name^, Date 

Organization .^ 

Street . 

City_^ State Zip Code 

or 
Country 



-Fold Here 



Do Not Tear - Fold Here and Staple 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



FIRST CLASS 

PERMIT NO. 152 

MARLBOROUGH, MA 

01752 



Postage will be paid by: 



Software Documentation 

200 Forest Street MR1-2/E37 

Marlborough, Massachusetts 01752 



